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INTRODUCTION 


Man Twain is thought to have been the first professional writer 
to use a typewriter. As with all writers since, the typewriter, 
operated by a series of mechanical levers, cranks, and pinions, made 
Twain a faster worker. He may even have been a better writer be- 
cause of the typewriter—the keyboard allowed him to commit his 
words to paper at a rate more compatible with his flow of thought. 

Considering Mark Twain’s contribution to American literature, 
you can only wonder what he would have written had he owned a 
personal computer and a word processor. Twain would never have 
been able to outpace the computerized word processor. Jammed keys 
are an impossibility. He could have written as fast—or as slowly— 
as he wanted. 

His editors would surely have appreciated it, too. Revisions would 
have been a snap; there’s no need to retype entire pages with a word 
processor. The appearance of manuscripts would have been im- 
proved by using common word processor features such as automatic 
underlining, centering, and changeable character pitch. And with a 
high-quality output device, like a laser printer, Twain’s words could 
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have been automatically converted to book form, avoiding time-con- 
suming and expensive typesetting. 

Twain didn’t have the luxury of the modern computer and word 
processor, but these tools are readily available to us today. Only 
short-sightedness or a fear of technology keeps them from being 
used. Whether you are in the business of writing best-selling novels, 
company reports, correspondence for the boss, or letters for the 
charity ball, a word processor helps you do your work faster and more 
professionally. 

But like sexy sports cars, once you get a taste of the efficiency of 
word processors, you find yourself transformed into a speed demon. 
You look for small, hidden tricks and techniques that help you be- 
come even more proficient. You start gauging your success not by 
the number of hours it takes to complete a task, but by the minutes— 
even seconds. You become impatient as the computer whirs, clicks, 
and processes your words, digesting tens of thousands of bits of in- 
formation in the wink of an eye. It’s not fast enough for you. You are 
possessed by the computer word processor speedbug. 

Fortunately, there’s a cure. If you use WordPerfect on your IBM 
PC or clone, you can speed up the process of writing, editing, and 
printing documents by at least another 50 percent, often much more. 
How? By using macros, styles, and templates. 


WHAT ARE MACROS, STYLES, AND TEMPLATES? 


In WordPerfect, macros are keyboard shortcuts for entering a long 
string of commands or typing lengthy passages of text. Once a macro 
is defined, it is recalled at any time by pressing a few keys. Any 
operation in WordPerfect can be assigned a macro— writing, edit- 
ing, drawing, formatting, spell checking—you name it. 

You can dramatically increase productivity and efficiency when 
working with WordPerfect by creating sets of macros for common 
tasks. For example, you can use macros to: 


Set up the format for a business envelope. 


Enter the company name and address automatically in correspon- 
dence. 


Generate a formatted and calculated invoice. 
Prepare an automated mailing list system. 
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Write preformatted “speedy reply” memos. 


Send out billing and dunning notices quickly and easily, whenever 
you want. 


Create mailing labels instantly in any format you desire. 


Prepare legal briefs, contracts, and other documents from readily 
available “boilerplate” text. 


Simplify the writing of special format documents, such as 
screenplays, lists, and tables. 


Automate the process of cutting, copying, and pasting text. 


If you’ve used the macros features in the earlier 4.2 version of 
WordPerfect, you know how they increased your productivity. The 
macros feature in WordPerfect 5.0 provides the same functionality, 
yet is far more advanced, offering a sophisticated programming lan- 
guage that makes your job behind the word processor even easier. 

Styles, another feature new to version 5.0 of WordPerfect, are 
simply a collection of formatting characteristics—like margin set- 
tings, tabs, and line numbering—stored together in one easily 
manageable packet. When you apply a style to a document, every for- 
mat you recorded with it is given to the document. Styles allow you 
to change formatting quickly and effortlessly, and maintain consis- 
tency throughout all of the documents. 

Templates are not a feature of WordPerfect, but an application you 
devise. Strictly speaking, a template is a ”bare-bones” document that 
you store on the disk for future use. Templates can be used with 
macros or styles, and are intended to automate the tasks you per- 
form frequently, freeing you from much of the grunt work that 
presents itself each day. For example, if you often prepare invoices 
for products or services, but don’t have a stand-alone accounting 
program for such a purpose, it’s a fairly easy matter to construct a 
ready-made template that you can use to produce and print the in- 
voice swiftly. 


THE APPLICATIONS DISK 


All of the functional macros, styles, and templates found in this 
book are included in the Applications Disk, packaged with this book. 
The inside back cover describes the disk’s contents and explains how 
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to use it. A Help macro on the disk itself (or Appendix A in the back 
of this book), explains how to access the files and use them with your 
copy of WordPerfect. Please note that WordPerfect 5.0 files—espe- 
cially macros and styles—are not compatible with earlier versions 
of the program. The files on the Applications Disk are designed only 
for WordPerfect version 5.0 or later. Refer to Appendix A for details 
on the contents of the Applications Disk, as well as how to use it (a 
complete listing of files on the Applications Disk is included in Ap- 
pendix B). NOTE: some macros depend on other macros or text files 
to operate properly. WordPerfect must be able to find these supple- 
ment files or The macro will not work. Refer to Appendix A for infor- 
mation on macro file handling. On-Line help for using the 
Applications Disk is included in a special HELP.WPM macro 
provided on the disk. See the inside back cover of the book for in- 
structions to running the Help macro. 


WHO THIS BOOK IS FOR 


This is not a beginner’s book on WordPerfect. It does not teach the 
fundamentals of WordPerfect and how to use its features, nor does 
it review these features. 

You are expected to have a good working knowledge of Word- 
Perfect already before you read this book. You need not be a pro, but 
at the very least you should know how to write and edit text, how to 
format text using codes, and how to print your documents. 
Knowledge of the program’s advanced features, such as the spelling 
checker, thesaurus, and automatic line numbering, is also valuable. 

New to WordPerfect? Then you are urged to read the manual that 
accompanies the program. A number of good books, including 
Beacham’s WordPerfect 5.0 Handbook and The WordPerfect En- 
cyclopedia (both from Bantam) offer excellent ancillary training for 
WordPerfect. If you are acquainted with WordPerfect, but are not an 
expert user, you'll want to keep a copy of the manual beside you as 
read this book. If you come across a technique or concept that is un- 
familiar, pause to read about it in the manual before proceeding. 

As of this writing, the latest release of WordPerfect is version 5.0. 
This book details the creation of macros and styles, and how they 


apply to this version, but many of the techniques will also work, with 
some modification, when using Version 4.2. 
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HOW THIS BOOK IS ORGANIZED 


Here is a brief summary of the contents of each chapter: 


Chapter 1—Macro Primer. What macros are and how they are 
used; types of macros for writing, editing, and formatting; command 
shortcuts; macro definitions (Alt-letter, named, and temporary); 
saving and executing macros. 

Chapter 2—Learning Advanced Macros. Using advanced features 
of pausing, chaining, and nesting with macros. 

Chapter 3—Macro Editing. Key remapping, using variables as 
macros, macro and key editing. 

Chapter 4—Macro Programming. An introduction to macro 
programming, programming concepts, programming statements and 
their uses, how to think like a programmer. 

Chapter 5—Macros and Merges in Menus. Using macros and 
merge documents to create menus. 

Chapter 6—Using Templates with Macros and Merges. Definition 
of a template and how its used; examples of template documents; two 
types of template documents—standard and merge—how to create 
both; how to store and use template documents. 

Chapter 7—Using Styles. Definition of styles and how to use them; 
sample styles. 

Chapter 8—Letters and Memos. Creating semi-block and full- 
block business letters, letterhead, and memos. 

Chapter 9—Boilerplate Business Correspondence. Using macros 
to create dunning and billing notices, merging letter templates, 
producing contracts from menu lists, maintaining and sorting data 
files. 

Chapter 10—Desktop Publishing. Using macros, styles, and 
templates to prepare multiple column documents, such as newslet- 
ters and reports. 

Chapter 11—Invoices, Statements, and Receipts. Documents and 
macros for preparing calculated invoices, statements of account, 
receipts for services or products, expense reports. 

Chapter 12—Mailing Labels and Envelopes. Preparing and print- 
ing 1- and 3-up mailing labels, printing envelopes. 

Chapter 13—Resumés. Types of resumés and their uses; generat- 
ing chronological, skill, and combination resumés; adding enhance- 
ments. 
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Chapter 14—Manuscript Preparation. Popular manuscript for- 
mats for single- and double-spaced documents; using macros, styles, 
and templates to create and edit headers, footers, footnotes, macros 
and styles for outlines and script formats. | 

Chapter 15—Macro Potpourri. Miscellaneous macros for creating 
electronic notepads, quizzes, adventure games, and more. . 

Chapter 16—Macro Strategies. Helpful tips and tricks for using 
WordPerfect macros, including saving, storing, retrieving, editing, 
and programming. . 

Chapter 17—Macro Debugging. Possible problems with 
programmed macros, and how to correct them. 

Chapter 18—Using Batch Files With WordPerfect. Useful DOS 
commands; writing and using batch files. 

Appendix A—Complete instructions for using the Applications 
Disk. 


Appendix B—Applications Disk Directory. A list of files on the Ap- 
plications Disk. 


CONVENTIONS USED IN THIS BOOK 


The following conventions are used in this book: 


Keys you press are shown in bold. Non-alphanumeric keys, such 
as the Spacebar, Enter key, and function keys, are shown in brack- 
ets. When two or more keys are to be pressed simultaneously, they 
are shown connected by a hyphen. Do not type the hyphen. 


Examples: 

Key Notation 

in Text Press these keys 

Test [Enter] “T “e,”“s.” “t” and “Enter.” 

[Alt]-F “Alt? and “F” keys simultaneously. 

[Ctrl]-[F10] “Ctr?” and “F10” function key simultaneously. 


The labeling of keys on various versions of the the IBM PC and 
compatibles may differ. This book uses the following standard 


references for the keys. 
Key Meaning 


[Esc] Escape 
[Tab] Tab express 
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[Ctrl] Control 

[Alt] Alt(ernate) 

[Shift] Key shift 

[Spacebar] Spacing bar at bottom of keyboard (usually 
unmarked) 

[Backspace] Backspace key usually key on top row, next to 
“+/=” key. 

[Enter] Enter (or Return) key in main part of keyboard, 
often marked as . You may 
also use the [Enter] key on the numeric keypad. 

[Insert] Insert or “Ins” key in keypad or cursor pad. 

[Delete] Delete or “De?” key in keypad or cursor pad. 

[Home] Home key in keypad or cursor pad. 

[Page Up] Page Up key in keypad or cursor pad. 

[Page Down] Page Down key in keypad or cursor pad. 

[End] End key in keypad or cursor pad. | 

[PrtSc*] Print screen key, found in various locations on 
different keyboards; used with the Shift key to 
make a printed copy of the screen display. 

[Fl]thru [F10] Function keys labeled F1 through F10. 


Text shown in bracketed italics indicate the kind of entry to be 
made, not the keystrokes. The actual entry will vary. Do not type the 
brackets unless you are otherwise told to do so. 


Examples: 

Entry Notation 

in Text Press these keys 

filename) Enter your own filename, such as “TEST.DOC” or 
“MYFIL. TXT.” 

(field entry) The entry of a text field for a merge print 


document, such as a person’s name, address, 
or account balance. 


A series of keystrokes are shown as a list. The numbers preceding 
each keystroke are for reference only. Do not type them. Keystrokes 
considered as one action are shown either on the same line or as one 
step comprising two or more lines. 
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Example: 
Key Sequence What it Does 


1. (Ctrl]-[F10] Starts new macro definition. 
2. {macro name) Names the macro. 


[Enter] 
3. [FT] Exits WordPerfect without 
Y saving the document. 
N 


You program macros from within a special editing box, accessible 
through the Macro Define, [Ctrl]-[F10], key. You may edit an al- 
ready created macro or define one from scratch. To edit or define a 
macro, press the same keys on the keyboard that you normally would 
to invoke some action in WordPerfect. For example, to clear the cur- 
rent document screen but not exit out of WordPerfect, you’d type: 


[E7] 
n 
n 


This book indicates the exact keys to press by showing you a print- 
out of the macro definition, such as: 


DELPAR.WPM 
(DISPLAY OFF) 
(Move}23 
(DISPLAY ON) 


This format assumes you already know how to access the macro 
editing screen. See Chapters 3 and 4 for more details. 

Most of the keys in the macro editing screen are self-explanatory. 
A more thorough discussion of macro keys can be found in Chapter 
6, “Macro Programming.” 

The list for the more complex programmed macros include 
reference numbers. Do not type the numbers. Following the macro 
code is an explanation of each referenced step of the macro. 


Example: 


1. (PROMPT)Press any key to continue.:-~ 
2. (ASSIGN) 1~~ 
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{LABEL} loop~ 
(LOOK}1~ 
3. (IF EXISTS}1~Thank you, please wait... 
(ELSE) (GO) loop~ 
(END IF} 


Empty spaces (made with the [Spacebar]) are shown in some 
programmed macro definitions as small dots in the center of the line. 
See Step 1, above, for an example. 

Macros described in this book are named so that you can easily 
find them on the Applications Disk. You may choose any name you 
wish, or rename already defined macros, but use care that you don’t 
choose a name already in use. 

Some macros activate other macros by name. If you change the 
name of a macro, be sure to update the macro definitions that are af- 
fected by the change. For example, if one macro calls another macro 
titled “DISKCNG.WPM,” and you change the name to “DIS- 
KSWAP.WPM,” you must redo the first macro to reflect the name 
change. 
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MACRO PRIMER 


| ere turning on a tape recorder in your computer to memorize 
everything you do on the keyboard. Press a series of keys to save a 
document on your hard disk, for example, and the computer remem- 
bers each key you pressed. Play back the recording, and the com- 
puter mimics your actions. That’s the idea behind WordPerfect 
Macros—memorizing your keystrokes and playing them back at the 
touch of a button. Of course, macros go way beyond this simple 
definition. You will learn all about macros, and the various functions 
they can perform, throughout the course of this book. 

For the sake of simplicity, WordPerfect macros can be divided into 
two categories: 


¢Keyboard recorded, where the keys you press are recorded in a 
special macro file. You play back the file and WordPerfect Bgpeats 
the original recording. 


e Programmed, where you use a programming language to instruct 
WordPerfect on what to do. 
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In this chapter, you'll learn what keyboard recorded macros are 
and how they are used. This chapter serves as an introduction only; 
more advanced macros techniques are covered in the following chap- 
ters. 


WHEN TO USE MACROS 


You can use macros for a wide variety of tasks. The way you use 
macros will depend on your application, and how often you do the 
same types of jobs. In any case, macros are used to simplify Word- 
Perfect and cut down on the amount of typing you do. You can define 
a macro to perform any task you would normally perform with Word- 
Perfect, but you should reserve macros for only those chores which 
you do on a fairly regular basis. 

As arule of thumb, you don’t need the macro if it isn’t used more 
than once or twice a week (assuming you sit behind the computer 
every day). Unless the series of keystrokes is very long and involved, 
youre better off tapping it out manually on the keyboard. Some ex- 
ceptions to this "rule" apply, however, particularly if WordPerfect is 
used by persons with little or no computer training. 

Using macros falls into four distinct categories: 


eTo automate command key sequences. 
eTo memorize passages of commonly used text. 
eTo simplify a series of formatting instructions. 


eTo program WordPerfect for use by others. 


Let’s take a closer look at each category and examine the special 
relationship it has with WordPerfect macros. 


To Automate Command Key Sequences 


WordPerfect employs a complex structure of menus, commands, and 
options using the computer's function keys. Some of the commands, 
such as underlining, document saving, and spelling, provide only one 
or two options and their simplicity does not require macros. 
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Other commands, however, have several layers of menus and 
using them requires you to choose the functions you want from a list 
that appears on the screen. If you find yourself choosing the same 
commands and options time and time again, you can automate the 
process by recording the keys as a macro. 


To Memorize Passages Of Commonly Used Text 


One common use of WordPerfect macros is memorizing passages of 
text for later playback. Instead of tapping out “WordPerfect” each 
time you write it, you record it as a macro and recall it at touch of a 
key. You can do the same thing with other text entries, as depicted 
in Figure 1-1, including your name and address, telephone number, 
company name, and common phrases such as “Sincerely,” “I look for- 
ward to your prompt reply,” and “You just won $10,000 in our ‘Wel- 
come to the Neighborhood’ sweepstakes!” 

The length of the passage of text is virtually unlimited—although 
very long text blocks are better saved as templates, because Word- 
Perfect can store macros no larger than about 5,000 characters. You 


FIGURE 1-1 LETTER WITH PASSAGES PLACED 


Standard boilerplate 
text 


AI PR SIAD DADS ANOS 
ROR: SAS 


Automatic insertion 
of text with macros 
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can use macros to store "boilerplate" text for use in contracts, legal 
briefs, reply letters, and other documents. Instead of typing com- 
monly used words and phrases, you record the text as a macro and 
insert it in your documents at any point you desire. Boilerplating al- 
lows you to customize your documents while saving time and effort. 

An often overlooked advantaged of using macros to store frequent- 
ly used text is that, because the characters are stored on disk in the 
exact form that you typed them, your accuracy and spelling im- 
proves. It’s easy to overlook typographical errors in the return ad- 
dress, salutation, or closing of a letter. Imagine how embarrassing 
it is to end your letter "Sincereky,' instead of "Sincerely." Of course, 
the spelling checker built inside WordPerfect may catch some or all 
such errors, but you may forget to check the letter before mailing it 
out. Perhaps a more serious error is entering the wrong return ad- 


dress, social security number, or phone number; items that the spell- 
ing checker does not review. 


To Simplify a Series Of Formatting Instructions 


WordPerfect’s default format settings are useful for routine letter 
writing, but for more advanced documents you need to alter the for- 
mat characteristics. Every element of appearance of WordPerfect 
documents is controlled by one or more of the computer’s function 
keys. To change the margins, for example, you press: 


¢(Shift]-[F8]. 
‘Option 2. 
‘Option 5. 


You then enter the desired right and left margins. Depending on 
the margin settings you want, this operation requires a minimum of 
10 keystrokes (including pressing the [Enter] key to accept the 
changes and return from the menus). 

Granted, the keystrokes necessary to change the margin settings 
are not overly complicated, so if you modify the margins only oc- 
casionally, you can continue to plunk away manually at the 
keyboard. But if you find yourself frequently switching between com- 
mon margin settings, you'll save a great deal of time by encoding the 
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changes as a set of macros. With standard margin settings stored as 
a macro, you can reduce the number of keystrokes to two—the [AIt] 
key and a single letter. 

Some document types require you to change the margins constant- 
ly. If you are writing movie scripts, for example, you need different 
margin and tab settings for dialog and action sections. In the typi- 
cal one hour TV script, you may change margins two or three 
hundred times. That equates to two or three thousand keystrokes 
that never appear in your script, and aren’t likely to help win you 
that Emmy award. By recording the various margins as macros, you 
can quickly recall the proper settings by pressing just a few keys. 


To Program WordPerfect For Use By Others 


Not everyone is a whiz at WordPerfect. If others in your office use 
WordPerfect, and they have little or no experience with it, you can 
program the software with macros to make it easier to use. A good 
example is creating and printing a mailing list. Normally, this re- 
quires fairly in-depth knowledge of WordPerfect. But by creative use 
of macros, you can program the software to prompt the user for the 
desired information and automate nearly the entire process. 

Even if you or others in your office are familiar with WordPerfect, 
macros can be used to simplify complicated tasks, particularly those 
that you may not do often. The macro stores all of the commands 
needed to complete a procedure, so you don’t have to remember 
which buttons to press. A sample menu screen, which uses macros to 
carry out various tasks, is shown in Figure 1—2. You can create a 
menu such as this one for any WordPerfect job you need done. 


BASIC STEPS 


There are five basic steps to defining a macro. 


eStep 1: Press [Ctrl]-[F10] to begin the macro definition. 


eStep 2: Name the macro in any of the following ways explained in 
the section below. 
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misty hale. Lining the narrow avenue were crowded brick 
buildings, tattered and worn from age, muddied from the recent 
rains. Once a proud and upwardly mobile neighborhood — forty, 
perhaps fifty years ago — the crumbling buildings nou housed a 
variety of small, mostly profitless enterprises — a used book 
store, an apothacary shop, an office for a unlicensed doctor. 
All were closed for the night: doors bolted shut, iron bars 
locked in place over the windous. 


A lone figure stood among the brick buildings, a figure 


1 Close Chapter 

2 Start Neu Chapter 

3 Check Spelling of This Chapter 

4 Convert Text to Typesetter Codes 
S Reformat for Telecomuntications 
Hake a selection 


FIGURE 1-2 MACRO MENU 


*Step 3: Describe the macro. Enter a line of text to describe the 
macro (up to 39 characters). The comment is visible only when 
editing the macro. The prompt Define Macro now appears on the 
screen. 


Step 4: Define the actual macro by entering the keystrokes you 
want recorded. While defining the macro, the prompt Macro Def 
flashes on the screen. 


¢Step 5: Press [Ctrl]-[F10] once more to complete the macro defini- 
tion. 


While defining a macro, WordPerfect will execute your commands. 
This helps you follow the course of the macro, but you may also in- 
advertently change your document in a way you don’t want. You can 
create macros without disturbing current work by switching to Doc 
2 (press the (Shift)-[F3] keys). After you complete the macro, switch 
back to the main document or close Doc 2 (press [E7], N, N). 
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TYPES OF MACROS 
WordPerfect creates four types of macros: 


¢Permanent Alt-key macros. 
o Permanent remapped-key macros. 
°Permanent named macros. 


°Temporary macros. 


Permanent Alt-key Macro 


WordPerfect can store up to 26 Alt-key macro definitions— one for 
each letter key. They are called Alt-key macros because of the way 
they are recalled: you press the [Alt] key and a letter key. 

To define an Alt-key macro: 


Key Sequence What it Does 

1. (CtrlJ-[F10] Starts macro recording. 

2. [Alt]-(Rey) Names macro with Alt-key combination (such as 
[Alt]-A or [AIt]-F). 

3. (description) Describes the macro. 


[Enter] 

4. {macro Defines macro (enter keystrokes to be recorded 
definition) here). 

5. (CtrlJ-[F10] Stops macro recording; saves macro file on current 


default disk. 


To replay an Alt-key macro, press the [Alt] key and the desired 
letter key simultaneously. For example, if you recorded a macro that 
changes the right margin from 74 to 55 as [AIt]-M, depress the [Alt] 
and M keys together. 

Alt-key macros are stored permanently on the default disk drive 
and can be accessed any time, even during subsequent sessions with 
WordPerfect. Alt-key macro files can be copied, deleted, and manipu- 
lated like any other WordPerfect file. 

WordPerfect automatically names the Alt-key macro file for you. 
You can easily identify Alt-key macro files by their name and .WPM 
extension (macros made with version 4.2 of WordPerfect, which can- 
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01701780 22:30 Directory D: \UPSGN, x í 
Document size: 3250 Free: 10149888 Used: 1869924 Files: 57 


. “CURRENT? <DIR> . © “PARENT > <DIR> 

BATCH . <DIR> 61/81/88 01:95 BUSLETS . <DIR> 81/82/88 B2:25 
CHARSETS. <DIR>? 01/01/880 82:54 GAME . < DIR? 017/02/88 B7: Z8 
GRAPHIX . <DIR> 01/81/88 83:32 KEYS e <DIR> 81/01/88 G1:!22 
MACROS , <DIR> 04/86/88 12:82 MISC j <DIR> 017/017890 12:12 
SPHMACROS. <DIR> 801/81/80 89:57 STYLES , < DIR? 81/81/88 23:54 
TEXT š <DIR> 04/86/88 12:83 61781780 | 
ALTI WPM 71 01/02/88 13:18 61701788 

ALTN UPH 431 01/81/88 22:29 ALTO ‚UPM 1261 01/7@1/80 22:29 
ALTQ . UPM 119 81/01/890 22:29 ALTU ‚UPM 411 017017868 22:23 
ALTU UPM 218 81/81/88 22:28 APLASEI I. PRS 7478 61/81/7688 89:18 
APLASPLU, PRS 28748 81/62/88 BA: 47 CENTFIG .WPM 173 017/02/89 01:190 
CHAPL . 3192 81/81/88 22:Z2 CONVERT .EXE 46592 09/08’87 16:04 


DOTEXPRI.PRS 61/82/88 


1 Retrieve: 2 Delete: 3 Move/Rename: 4 Print: 5 Text In: 
6 Look; 7 Other Directory; B Copy; 3 Word Search; N Name Search: 


FIGURE 1-3 DIRECTORY WITH MANY ALT#.WPM FILES 


not be used in version 5.0, have the extension .MAC). The name is 


always "ALT" plus a single letter key. A WordPerfect directory show- 
ing a series of ALT#,WPM files is shown in Figure 1-3. 


Examples: 


ALTA. WPM—for the [Alt] and A key combination. 
ALTD.WPM—for the [Alt] and D key combination. 


Alt-key macros can be on any disk and any directory; however, if 


the macro file is not on the current drive and directory, WordPerfect 
will not be able to find it. 


Permanent Remapped-key Macros 


WordPerfect allows you to reassign (or "remap") nearly every key on 
the keyboard. For example, you can change the standard "QWER- 
TY” keyboard layout to the Dvorak layout by reidentifying the al- 
phabet keys. The reassigned keys may include multiple keystrokes. 


Macro Primer 9 


For instance, the [Shift]-[F7] key, which normally calls up the print 
menu, might be remapped.to call up the print menu, select Draft 
Quality print, then begin printing the entire document. In this way, 
the remapped keys behave like macros. In fact, you edit and program 
the keys the same way as you do macros. 

Keyboard remapping uses the keyboard layout option in the Setup 
menu. The exact procedure for key remapping, which is an advanced 
topic, is detailed in Chapter Five. 


Permanent Named Macro 


The Alt-key macros are the easiest to use because you can replay 
them by pressing just two keys (the [Alt] key and a letter key). You 
should record the most common procedures as Alt-key macros. But 
any serious WordPerfect user will quickly run out of [Alt]-letter key 
combinations. As an alternative, you can save macros under a name 
you provide. Once saved, you recall the macro by pressing [AIt]- 
[F10], the Macro key, then entering the name of the macro you want. 


To define a named macro: 


Key Sequence What it Does 
1. [(Ctrl]-[F10] Starts macro recording. 


2. name) Names macro using any name 
[Enter] with one to eight characters. 
3. (description} Describes macro. 
[Enter] 
4. (macro Defines macro (enter keystrokes to be recorded 


definition} here). 
5. [(Ctrl]-[F10] Stops macro recording; saves macro file on disk. 


To replay a named macro: 


Key Sequence What it Does 

1, [Alt]-[F10] Execute playback macro command. 
2. (name} Defines name of macro to use. 

3. [Enter] Initiates macro playback. 


Permanent named macros are stored on the current default disk 
drive, just like Alt-key macros. Named macro files can be identified 


10 WordPerfect 5.0 Macros and Templates 


by their. WPM extension. To end a macro playback before it was com- 
pleted, press [F1] 
Examples: 


SALUTE.WPM—for a salutation macro for use at the start of 
letters. 

LET-HEAD.WPM—for a letterhead macro. 

MERGE. WPM—for a merge print macro. 


Macro naming conventions are the same as with DOS files. Macro 
Names may contain from one to eight characters. You may use any 
combination of letters or numbers in the file name as well as most 
symbols, except the following: 


¢Any control character, including Escape and Delete. 
A space. 


*These characters: 4 +=/\[]";:2* <>l,. 


*A period (WordPerfect automatically adds the period and WPM 
file extension; you don’t need to do it yourself. 


To access a macro not stored on your default drive and directory, 


enter the drive and/or the directory before the macro name. 
Examples: 


*C:macros\dblspace—Finds the macro DBLSPACE.WPM (for 
double-space) in the macros directory on drive C. 


*A:dblspace—Finds the macro DBLSAPCE.WPM on drive A. 


*macros\format\dblspace—Finds the macro DBLSPACE.WPM on 
the current drive in the macros and format subdirectories. 


You may omit the drive and directory if you have told WordPerfect 
where to look for the macro files. The Location of Auxiliary Files op- 
tion in the Setup menu allows you to identify a regular repository 
for your macros files. As you become a proficient user of macros, you 
will want to take advantage of this feature. It will make storing and 
finding macros much easier if you keep them on a separate disk or 
in a subdirectory. 

You can still keep some macros in the main WordPerfect disk 
and/or directory (the one that contains the WP.EXE file). If Word- 
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Perfect can’t find the macro it needs in the spot specified in the Loca- 
tion of Auxiliary Files option, it checks back in the WP.EXE direc- 
tory. 

If you are not sure how to create subdirectories, consult your DOS 
manual or look it up in any book on MS-DOS. In addition, Word- 
Perfect will create subdirectories for you if you define one after 
selecting List Files ([F5]) key and pressing the = sign. Enter the 
name of the new subdirectory, then answer Y to the prompt. 


Temporary Macro 


Not all macros need to be stored for future use. You may have oc- 
casion to create a temporary macro that you use for the current writ- 
ing and editing session only. When you exit WordPerfect, the macro 
is erased. The advantage of a temporary macro is that you won’t clut- 
ter up your disks with a macro you may create and use only on one 
special occasion. 

WordPerfect 4.2 allowed you to make up to 27 temporary macros, 
but version 5.0 permits only one. Temporary macros are assembled 
in nearly the same manner as permanent Alt-key macros. To define 
a temporary macro: 


Key Sequence What it Does 
1. (CtrlJ-[F10] Starts macro recording. 


2. [Enter] Creates temporary macro. 
3. (description) Describes the macro. 
[Enter] 
4, {macro Defines macro (enter keystrokes to be recorded 


definition} here). 
6. [(Ctrl]-[F10] Stops macro recording; saves macro file on disk. 


To playback the temporary macro: 
Key Sequence What it Does 
1. [Alt]-[F10] Invoke playback macro command. 


2. [Enter] Defines name of macro to use. 


If you redefine the Enter-key temporary macro, WordPerfect will 
remind you that it already exists and will ask it you want to replace 
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it or edit it. If you select Replace, the previously recorded macro is 
erased and the new one takes its place. 

While the Enter-key macro is technically "temporary," Word- 
Perfect records it on the disk as WP(WP).WPM. Although not really 
useful, you might note that WordPerfect also creates a temporary 
macro when you press the [F2], [Shift]-[F2], [F7], [Down], or 
[Shift]-[Enter] keys. However, the program uses the same 


WP(WP).WPM file, so you still only have one temporary macro to 
work with. 


ERASING AND REDEFINING MACROS 


If you choose a name for a macro that already exists, you are given 
a chance to cancel the macro definition, to erase the previous macro 
and start over, or to edit the existing macro. 


eTo cancel the new definition, press 0 or [F1]. 
eTo erase the previous macro and start over, enter 1. 


eTo edit the existing macro, enter 2. 


CAUTION: Accidentally pressing 1 when you meant to cancel or 
edit the macro will irretrievably erase the existing macro! Make ita 
habit to wait for the prompt that appears in Figure 1—4 before 
proceeding with describing or defining the macro. 


HANDS ON: CREATING A MACRO 


Let's gain some practical experience creating macros in Word- 
Perfect. Follow the short tutorial that appears below to create two 
macros for toggling between single and double spacing. Since these 
macros will be used a lot, we'll save them as Alt-key macros, so that 
they can be quickly and easily retrieved. (Remember that the step 
numbers in the following exercises are for reference only; do not type 
them in.) Begin by starting WordPerfect in the usual manner. 
Let's create the "Switch to Single-Space” macro first: 


TEST.WPM is Already Defined. 
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1 Replace; 2 Edit: B 


FIGURE 1-4 MACRO REDEFINITION PROMPT 


Key Sequence 


1 
2 
3 


5 
6 
7 
8 
9 


. (Ctrl]-[F 10] 

. [Alt]-S 

. Single-space[Enter] 
. (Shift]-[F8] 

.1 

.6 

oe 

.000 

. (Ctrl]-[F10] 


What it Does 

Starts new macro definition. 
Names single-space macro as ALTS.WPM. 
Describes the macro as Single-space. 
Chooses Format command. 

Selects the Line option. 

Selects the Spacing option. 

Sets spacing to 1. 

Returns to the document. 

Completes macro definition. 


¢Steps 1, 2, and 3 prepare the macro for recording. 


eSteps 4 through 8 are the actual contents of the macro (they are 
the exact steps you follow to manually change the line spacing). 


¢Step 9 completes the macro and saves it on the disk. 


The "Switch to Double-Spacing” macro is the same except for the 
macro name and the number of lines (spacing) selected: 
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Key Sequence What it Does 

1, (Ctrl]-[F10] Starts new macro definition. 

2. [Alt]-D Names double-space macro as ALTD.WPM. 

3. Double-space Describes the macro as Double-space. 
[Enter] 

4, (Shift]-[F8] Chooses Format command. 

5.1 Selects the Line option. 

6.6 Selects the Spacing option. 

1.2 Sets spacing to 2. 

8.000 Returns to the document. 

9, [Ctrl]-[F10] Completes macro definition. 


To recall either macro, press the [Alt] key and either D or S. You 
can confirm that the macro is working by using the Reveal Codes 
command, [Alt]-[F3]. Each time you invoke one of the macros, anew 
line spacing code is inserted at the cursor, as shown in Figure 1—5. 


FIGURE 1-5 LINE SPACING CODES ON SCREEN 


Doc Z Pg 1 Ln 1 P 


[Ln Spacing:2](€Ln Spacing: Z)£Ln Spacing:1)£Ln Spacing: "i 


Press Reveal Codes to restore sereen 
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CANCELING A MACRO 


You may cancel a macro in execution at any time by pressing [F1]. 
Note that most macros are replayed very fast, and that a series of 
even 100 keystrokes may take only a moment to replay. You won’t 
have time to press the [Cancel] key before the macro finishes. 
Rather, canceling a macro is handy when the macro has been slowed 
down or when you want to exit from a loop in a programmed macro. 

You may cancel a macro that you are defining by pressing the 
(Ctrl]-[F10] key. That ends the macro but it also saves what you've 
done so far on the disk. If you don’t want the macro, delete it from 
the disk or create a new macro using the same name (see the section 
above on Erasing And Redefining Macros). 


IMPORTANT TOPICS 


This chapter detailed the basics of WordPerfect macros. 


eMacros duplicate keyboard entry and WordPerfect command 
keys. You can use macros as a shortcut for any WordPerfect task 
or application, but they should be reserved for those jobs that you 
do on a regular basis. 


Using macros falls into four distinct categories: to automate com- 
mand key sequences; to memorize passages of commonly used 
text; to simplify a series of formatting instructions; and to 
program WordPerfect for use by others who have no or little com- 
puter experience. 


¢There are five basic steps to defining a macro: 


1. Press [Ctrl]-[F10] to begin the macro definition. 

2. Describe the macro. 

3. Name the macro. 

4. Define the actual macro by entering the keystrokes you want 
recorded. 

5. Press [Ctrl]-[F10] once more to complete the macro definition. 


e WordPerfect creates four types of macros: permanent Alt-key, per- 
manent remapped-key, permanent named, and temporary. 
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‘The procedure for creating permanent Alt-key macros iS: 


Key Sequence 

1. [Ctrl]-[F10] 

2. [Alt]-(key) 

3. (description) 
[Enter] 

4, (macro 

definition} 
5. (Ctrl]-[F10] 


What it Does 

Starts macro recording. 

Names macro with Alt-key combination. 
Describes the macro. 


Defines macro. 


Stops macro recording; saves macro file on 
current default disk. 


eTo define a named macro: 


Key Sequence 
1. {Ctrl]-[F10] 


2. (name) 


3. (description) 
[Enter] 
4, (macro 
definition} 
5. (Ctrl]-[F10] 


What it Does 
Starts macro recording. 


Names macro using any name [Enter] with two 
to eight characters. 
Describes macro. 


Defines macro. 


Stops macro recording; saves macro file on disk. 


¢To define a temporary macro: 


Key Sequence What it Does 

1. (Ctrl]-[F10] Starts macro recording. 

2. [Enter] Names macro. 

3. (description) Describes the macro. 

[Enter] 
4. (macro Defines macro (enter keystrokes to be recorded 
definition) here). 

5. [Ctrl]-[F10] Stops macro recording; saves macro file on disk. 
eTo replay a Alt-key macro. 

Key Sequence What it Does 


1. [Alt]-(letter} 


Activates Alt-key macro. 
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eTo replay a named macro: 


Key Sequence What it Does 

1. [Alt]-[F10] Invoke playback macro command. 
2. name) Defines name of macro to use. 

3. [Enter] Initiates macro playback. 


oTo replay a temporary macro: 


Key Sequence What it Does 
1. [Alt]-[F10] Invoke playback macro command. 
2. [Enter] Replays temporary macro. 


¢You may cancel a macro in execution at any time by pressing the 
[F1] (Cancel) key. 


CHAPTER 2 
LEARNING ADVANCED 


MACROS 


There are a number of advanced macro features that are helpful in 
everyday applications of WordPerfect. These advanced features are 
part of WordPerfect and are documented in the WordPerfect manual. 
They are, however, worth reiterating here. Many more advanced 
macro features are covered later in this book. Most of these are not 
documented in the WordPerfect manual. These special features are 
tips and tricks that stretch the macro feature to provide new and un- 
usual functions. 


PAUSING MACROS FOR USER INPUT 


Macros can be paused anywhere during playback and instructed to 
await direct keyboard entry. Pausing is helpful when you want to 
automate a process but still need to provide variable information. 
You can used paused macros, for example, to generate invoices. The 
macro creates the general form of the invoice, while pausing to allow 
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you to enter data. Figure 2-1 shows the concept of using a paused 
macro to fill out an invoice. 


Another example is automating a standard form letter. One 
method of creating form letters is to use the merge print feature of 
WordPerfect. The merging process is time consuming if you mail out 
only a few letters. Another approach is to create a macro where 
standard (boilerplate) text is inserted for you. The computer stops 
at certain spots in the letter to allow you to enter specific informa- 
tion, such as the current date, the name of the addressee, the saluta- 
tion, and so forth. Each pause ends when you press [Enter]. 

Follow these steps to add a pause during a macro: 


Key Sequence What it Does 
1, (Ctrl]-[F10] Begins a new macro definition. 
2. name) Names the macro. 
[Enter] 
3. (description) Describes the macro. 
[Enter] 


4, {macro definition) Defines the keystrokes for the first 
portion of the macro. 
5, (Ctrl]-[Page Up]1 Indicates that you want to add a 


FIGURE 2-1 PAUSED MACRO TO MAKE INVOICE 


Pause 


pie C 


KrakerJack Nut & Bolt Co. 
123 Main St. 
Anytown, YZ 12345 


CEER | | S | | See | | Pause for each column 
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pause. 

6. [Enter] Enters a pause. (Don’t forget to press 
[Enter] or the pause won't work. 

7. (macro definition) Defines keystrokes for the remainder of 
the macro. 

8. (Ctrl]-[F10] Completes macro definition. 


Though the steps outlined above show one pause between two 
macro definition segments, you can insert as Many pauses as you 
like during the macro. Simply repeat steps 5 and 6 for each new 
pause. 

To use the paused macro, replay it as usual. When the pause is 
encountered, the macro halts and awaits text from the keyboard. 
Type the text and when finished, press [Enter]. The macro will con- 
tinue and either finish, or pause at the next stop. Always remember 
to press the [Enter] key when you are finished entering the text 
from the keyboard. This signals WordPerfect that yeu are done with 
the entry and the macro continues. 


Hands-On Pausing 


Let’s create a simple memo header using pausing. The memo will 
stop several times to allow you to enter the current date, the subject, 
and other pertinent information. 

This Macro is called MEMO.WPM. and is found on the Applica- 
tions Disk in the CHAP2 directory. All macros included on the Ap- 
plications Disk are identified by the name and directory location in 
the text. 


MEMO.WPM (in CHAP2 directory of Applications Disk) 


Key Sequence What it Does 

1. [(Ctrl]-[F10] Starts macro definition. 

2. memo [Enter] Names the macro "memo." 

3. Memo header Describes the memo. 
[Enter] 

4. Date: Types "Date:" 

5. [Ctrl]-[PageUp] Pauses for Date: input. 
1 [Enter] 


6. [Enter] [Enter] One blank line. 


22 WordPerfect 5.0 Macros and Templates 


7. Subject: Types “Subject:" 
8. [Ctrl]-[Page Up] Pauses for Subject: input. 
1 [Enter] 
9, [Enter] [Enter] One blank line. 
10. To: Types To:. 
11. (Ctrl]-[Page Up] Pauses for "To: input. 
1(Enter] 
12, [Enter] [Enter] One blank line. 
13. From: Types "From:" 
11. [(Ctri]-[Page Up] Pauses for From: input. 
1 [Enter] 
12. [Enter] [Enter] Two blank lines. 
[Enter] 
13.({Ctrl]-[F 10] Ends macro definition. 


When you replay the macro, it will write the Date:, Subject:, To 
and From: fields, as shown in Figure 2-2, allowing you time to enter 


the specific information manually. Press the [Enter] key each time 
you finish with a line. 


FIGURE 2-2 AUTO MEMO PARTWAY THROUGH COMPLETION 


Inter Office Memo 
DATE: 2/10/89 


SUBJECT: Coffee Breaks 
FROM: The BOSS 


TO! The Workers 


It has corm to my attention that you workers are taking the full 
18 minutes allotted to you. This is not in keeping with the 


SS 


Doc Z Pg 1 Ln 12 Pos i 
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HIDING DISPLAY DURING MACRO EXECUTION 


Normally, WordPerfect starts each macro with the display turned 
off. With the display off, commands and menus aren’t shown during 
macro execution, and the macro works much faster. However, the 
screen may remain blank if the macro stops in the middle of some 
menus. To prevent this, add a "display on" code at the very end of 


the macro. 
Key Sequence What it Does 
1. [Ctrl]-[F10] Begins a new macro definition. 
2. (name) [Enter] Names the macro. 
3. (description) Describes the macro. 
[Enter] 
4. {macro definition) Defines the keystrokes for the macro. 
5. [Ctrl]-[Page Up] 2 Indicates that you want to 
control the display. 
6. Y Turns the display on. 
7. [Ctrl]-[F10] Completes macro definition. 


The display option can be turned on and off at any point within 
the macro. Press [Ctrl]-[Page Up], then 2 to access the Display 
menu. Press N to turn the display off and Y to turn the display on. 


SINGLE MACROS AND MACRO SETS 


Some operations, like changing between single and double spacing, 
require only one macro. More advanced operations, such as prepar- 
ing a mailing list from a data document, filling out an invoice, or 
creating a table of contents, may require two or more macros, or else 
one programmed macro. When using separate macros, you invoke 
each one in turn to complete the task. For the sake of clarity, we'll 
refer to macro sets by function, either as separate macros or chained 
macros. Although you create the two types in much the same fashion, 
they are used in different ways. 
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Separate Macros 


The easiest way to create a macro set is to define each macro with 
one specific purpose. Instead of recording one macro that changes 


the margins, resets the tabs, and generates a header and footer, you 


create several macros that each have a separate function. In the ex- 


ample, 


*MAC1 changes the margins. 


*MAC2 resets the tabs. 


*MAC3 generates a header and footer. 


Figure 2-3 shows the concept of macro sets using separate macros. 
Used this way, macro sets allow youa great deal of flexibility. You 
use only those macros that you need for a particular task. If you need 
to generate a header and footer, use just the header/footer macro. If 
you need to change the margins and tabs, use the margin and tabs 
macros. Of course, you need to replay each macro separately. That 


set. 


FIGURE 2-8 SEPARATE MACROS 


e Change margins. 


e Set tabs. 


e Generate header/footer 


Single macro 


means more keystrokes for you as you recall all the macros in the 


e Change margins. : 
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e Change margins. i 


Go to Set Tabs Ẹ 
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e Set tabs. $ 
Go to generate head/foo 
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FIGURE 2-4 MACRO CHAINING 


Chaining 


Macros can invoke other macros. This is called chaining. With chain- 
ing, you can easily step from one macro to the next. You start the 
first macro (the root) yourself. When the root macro finishes, it 
automatically calls up a second, or sub, macro. When that macro 
finishes, yet another one can be automatically started, as depicted 
in Figure 2—4. You can continue these macro "links" to make a chain 
as long as you like. 

Chaining relieves you of manually starting each macro in the set. 
But use chaining with caution. Macros refer to other macros in the 
chain by name and if you delete a macro, or alter its name, the chain 
will be broken. Keep a record of your macro chains to help you from 
inadvertently disturbing the links. Follow these steps to make a 
macro chain. This example assumes you are creating a chained 
macro with two links; one called MACRO-A and the other called 
MACRO-B. For the sake of simplicity, we'll assume that MACRO-B 
already exists. 


Key Sequence What it Does 

1. [(Ctrl]-[F10] Begins a new macro definition. 

2. MACRO-A Names the new macro MACRO-A. 
[Enter] 

3. Macro-A Describes the macro as Macro- A. 
[Enter] 

4, (macro definition} Defines keystrokes for MACRO-A. 

5. [Alt]-[F10] Starts sequence for MACRO-B. 


6. MACRO-B Invokes MACRO-B. 
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7. [Enter] Accepts the name; replays MACRO-B. 
8, (Ctr}]-[F10)] Completes macro definition. 


Steps 1 through 4 define the macro for MACRO-A. 
‘Steps 5 through 7 start MACRO-B. 


¢Step 8 completes the macro definition and returns you to editing 
mode. 


MACRO-B is not actually replayed while you are creating 
MACRO-A. That prevents the keystrokes from MACRO-B from 
being included as part of MACRO-A. Wher you start MACRO-A, 
MACRO-B is automatically run. You can also start MACRO-B nor- 
mally, without using MACRO-A. 


Creating A Macro Linker 


Another way to chain separate macros into a Set is to use a separate 
macro linker. The linker is a "bare-bones" macro that does nothing 
but call other macros. It does this by the use of "nesting," a proce- 
dure whereby WordPerfect starts one macro but before it has ended, 
branches off to another macro. When the second macro finishes, 
WordPerfect returns to the first macro. The concept of nesting is 
shown in Figure 2—5. You can write the linker using WordPerfect’s 
macro language, but if the macro is not too complex, you can create 
it directly from the keyboard. 

First, build the branch macros that you want to use; that is, create 
the macros that you will be nesting to. Let’s say that you are creat- 
ing a macro set that includes three branches: 


1. Set margins to 1.5" on both sides. 
2. Remove all tabs but one at the 3” mark. 
3. Turn justification off and line numbering on. 


Give each macro an Alt-letter name; nesting won’t work otherwise 
(you can build nested macros without using Alt-letter macros, but it 
requires the use of the macro programming language). For our ex- 
ample, let’s name these macros Alt-A, Alt- B, and Alt-C. Now create 
the linker macro, the one that will branch off to each of the three 
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; Main Macro 
First part of macro 


Nest Command 


Macro picks up 
where it left off 


Rest of macro 


Macro contents 
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FIGURE 2-5 NESTING CONCEPT 


others in turn. Define the macro by pressing the [AIt]-A, [AIt]-B, 
and [Alt]-C keys in turn. 
Hands-On Macro Nesting 


So much for theory; now for practice. You can experiment with a 
simple macro linker by creating these four macros. 


For Alt-A: 
1. (CtrlJ-[F10] Starts macro definition. 
2. [Alt]-A Names the macro "Alt-A." 
3. Macro A Describes the macro. 
[Enter] 
4, This is Macro Text for macro. 
A [Enter] 
5. [Ctrl]-[F10] Ends macro definition. 


Repeat the same procedure for making the AIlt-B and Alt-C 
macros, but change the name, description, and definition as re- 


28 WordPerfect 5.0 Macros and Templates 


quired. When the the Alt-letter macros are finished, create the 


linker. 

Key Sequence What it Does 

1. (Ctrl]-[F'10] Starts macro definition. 

2. Linker Names the macro ("Linker" in 
[Enter] this example). 

3. Linker macro Describes the macro. 
to A,B,C[Enter] 

4, [Alt]-A Nests in macro Alt-A. 

5. [Alt]-B Nests in macro Alt-B. 

6. [Alt}-C Nests in macro Alt-C. 

7, (Ctrl]-[F10] Ends macro definition. 


When you run the linker macro, it branches off to each Alt- letter 
macro in turn. The screen should read: 


This is Macro A 
This is Macro B 
This is Macro C 


Repeating Macros and Chains 


You may repeat a macro as many times as you like using the [Esc] 
key. Before executing the macro, use the [Esc] key to indicate the 
number of times you want the macro repeated. For example, to 
repeat a macro named "BOX" five times, type the following: 


Key Sequence What it Does 

1. [Esc] Initiates repeat. 

2.5 Sets repeat to five times. 

3. [Alt}-[F10] Invoke play back macro command. 
4. BOX Indicates macro to run. 

5. [Enter] 


Accepts the entry; macro is repeated 
five times. 


Figure 2-6 shows the result of the repeated macro. 
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FIGURE 2-6 FIVE BOXES 


Repeating Chains 


Repeating chain macros use the search feature to repeat a certain 
number of times automatically. Repeating chain macros have an ad- 
vantage over [Esc] key macros in that they will continue to work 
until the search results in a *not found* message. You don’t have to 
manually calculate the number of times to repeat the macro. 

Repeating chains use one macro that chains back to itself. Follow 
this procedure to create a repeating chain, as depicted in Figure 2— 
7. 


1. Begin defining the macro. 

2. Enter the keystrokes and include a search of some type. 
3. Call the macro from within itself. 

4. End the macro. 


Though repeating chains can be useful, most of their applications 
can be duplicated using WordPerfect’s Replace command. The excep- 
tion is when you must make a change that can’t be entered into the 
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FIGURE 2-7 REPEAT CHAIN MACRO 


replacement string. For example, say that you need to reformat a 
document that’s been imported from another word processor. The 
file has five empty spaces at the beginning of each paragraph instead 
of tabs. What’s worse is that the document lacks soft returns. It’s a 
fairly long document and you don’t want to hunt out each hard return 


in the middle of a paragraph and remove it. After exchanging the 
empty spaces for tabs, create this macro. 


Key Sequence What it Does 

1. [Ctrl]-[F10] Starts macro definition. 

2. softcony [Enter] Names macro "softconv." 

3. Convert to soft Defines macro. 
returns [Enter] 

4, [F2] Calls up search. 

5. [Tab] Inserts [Tab] code in search string. 

6. [F2] Starts search. 

7. [Alt]-[F4] Turns block on. 

8. [F2] [Tab] [F2] Searches for next [Tab] code. 

9. [Left] Moves cursor back three spaces 
[Left] (past [Tab] and [HRt] codes). 
[Left] 

10. [Alt]-[F2] n Calls up replace; no confirm. 


11. [Enter] Inserts [HRt] code in search string. 
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12. [Alt]-[F2] Starts replace for selected 
block only. 

13. [Alt]-[F10] Invokes macro. 

14. softconv [Enter] Calls up softconv macro. 

15. [(Ctrl]-[F10] Ends macro definition. 


°Steps 1 through 3 creates and defines the macro. 

°Steps 4 through 6 searches for the [Tab] code at the beginning of 
each paragraph. 

°Step 7 turns the block function on. 


°Steps 8 and 9 search for the next [Tab] code (at the beginning of 
the following paragraph). The macro then steps back three spaces 
to end the block selection immediately before the last hard return 
code in the preceding paragraph (easier done than said}). 


oSteps 10, 11, and 12 replace the hard return codes with nothing 
(WordPerfect automatically inserts soft returns). 


°Steps 13 and 14 repeats the softconv macro—effectively looping 
the macro back on itself. 


To use the macro, position the cursor at the beginning of the docu- 
ment and start the softconv macro. The macro will repeat itself 
until it finds no more [Tab] codes, at which time the *not found* mes- 
sage is displayed and the macro ends. 

The *not found* message indicates to WordPerfect that an error 
has occurred. In turn, WordPerfect halts macro execution, in case 
there is something seriously wrong. Repeating chain macros are a 
good example of how to take advantage of the error fail-safe feature 
built into WordPerfect. But you may have an occasion someday to 
construct a macro that ignores error conditions, or even does some 
specific action when an error occurs. WordPerfect 5.0 permits both, 
as explained in Chapter 4, "Macro Programming." 


Conditional Chains 


WordPerfect 4.2 provided a method of creating semi-intelligent 
macros by the use of "conditional chains." The technique takes ad- 
vantage of the way the program’s search feature works. 
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WordPerfect 5.0 does not allow you to construct conditional chains 
in the same manner, requiring instead that you write a conditional 
macro using programming statements. If you have version 4.2 con- 
ditional macros, you'll need to rewrite them in order to perform the 
same function in version 5.0. Although future chapters detail the 
macro programming language more fully, it’s worth covering to some 
extent here. 


WordPerfect 4.2 conditional chains used three separate macros: 


¢The main "do" macro, which contained a search. 


eAn auxiliary "found" macro, which WordPerfect ran when the 
search proved successful. 


¢An auxiliary "not found" macro, which WordPerfect ran when 
the search failed. 


The "do" and "found" functions could also be combined into one 
macro, The concept of the conditional macro is shown in Figure 2-8. 


The typical "do" or main macro (called "mainmac" here) would have 
use this construction: 


Key Sequence What it Does 

1. [Alt]-[F10] Indicates the macro to use when 
notfound the search fails. 
[Enter] 


2. (macro contents) Contents of the macro (including, in this 


case, a search). 
Repeats main menu. 


3. [Alt]-[F10] 


mainmac [Enter] 


FIGURE 2-8 CONDITIONAL MACRO 
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The main macro ignores the first step and proceeds with the macro 
contents. As long as the search string passes, the macro repeats it- 
self. But when the search fails, it exits and calls up the "notfound" 
macro. 

The same operation can be performed, with better results, with 
the {ON NOT FOUND) statement available when editing macros in 
version 5.0 of WordPerfect. To convert your old conditional macros 
for use in WordPerfect 5.0: 


1. Keep the "notfound” macro as is. 

2. Rewrite the main macro so that it includes the {ON NOT 
FOUND) statement at the beginning. 

3. Keep the body of the main macro the same, retaining the search. 

4. At the end, use the (GO) statement to loop back to the beginning 
of the main macro. 


When the main macro is run, WordPerfect notes what it’s sup- 
posed to do when a search ends with a *not found* message. As long 
as WordPerfect finds what it’s looking for, the main macro is 
repeated. When the search comes up empty, the macro branches off 
to the "notfound" macro. A basic macro, as viewed in the macro edit- 
ing editor and using hard returns as the search string, is shown in 
Figure 2-9. 


DESIGNING MACROS 


Simple, one-function macros can be created without a blueprint or 
flow chart but you should give extra thought and consideration to 
macros that are more complex in nature. You may find it helpful to 
draw a programming flow chart that includes the basic steps of the 
macro. In each box is a complete step; arrows connect the boxes to 
indicate the progress of steps throughout the macro. Flow charts, 
like the one in Figure 2—10, are particularly handy when creating 
chained or nested macros, because the drawing helps you visualize 
the function and flow of each macro. 

While you are planning the macro, note the steps required to 
create it. On a scrap document, go through the motions of executing 
the macro—but don’t record it just yet. On a piece of paper, note the 
commands and menu options you choose to complete the task. Don’t 
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Macro! Edit 
File MACROS\BACKPR1. UPM 


1 - Description Backuards printer 
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Selection: 2 


FIGURE 2-9 SAMPLE ON NOT FOUND CONDITIONAL MACRO 


FIGURE 2-10 SAMPLE FLOWCHART 
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forget the [Enter] key. Be sure to note each time you press it. When 
you think you have the procedure mapped out, define the macro and 
record it. | 

If you make a mistake, you can either cancel the recording by 
pressing [Ctrl]-[F10] again or editing out the errors later. Small 
mistakes usually make no difference, but you'll want to get into the 
habit of cleaning up your macros once you have created them. 

After defining the macro, try it out to make sure it works the way 
you originally planned. If you spot a mistake, double-check the steps 
you took and redefine the macro. 


IMPORTANT TOPICS 
oTo add a pause in a macro execution, enter the following: 
Key Sequence What it Does 
1. [Ctrl]-[F10] Begins a new macro definition. 
2. (name) [Enter] Names the macro. 


3. (description) [Enter] Describes the macro. 

4. MImacro definition) Defines the keystrokes for the first 
portion of the macro. 

5. [Ctrl]-[Page Up] Indicates that you want a 


1 pause. 
6. [Enter] Enters a pause. 
7. {macro definition) Defines keystrokes for the remainder of 
the macro. 
8. [Ctrl]-[F10] Completes macro definition. 


Repeat steps 5 and 6 for each pause. When replaying the macro, 
press [Enter] to finish the pause and continue execution. 


eTo hide or show the display during macro execution, enter the fol- 


lowing: 
Key Sequence What it Does 
1. [Ctr1]-[F10] Begins a new macro definition. 
2. name) Names the macro. 
[Enter] 


3. (description) Describes the macro. 
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[Enter] 


4, (macro definition) Defines the keystrokes for the macro. 
5. [Ctrl]-[Page Up] Indicates that you want to 


2 control the display. 
6.Y Turns the display on. 
or 
N Turns the display off. 
7. [(Ctrlj-[F10] Completes macro definition. 


¢For ease of use, divide basic macros into functional groups or sets. 
Start each macro separately as you need it. 


*Macros may be executed automatically by chaining them to the 


end of another macro. At the end of the first macro, add [AIt]- 
[F10], the name of the second macro, and add [Enter]. 


¢Nested macros are created by calling an Alt-letter macro while 
defining another macro. 


Key Sequence What it Does 
1. (Ctrl]-[F10] Starts macro definition. 
2. (name) Names the macro. 
[Enter] 
3. (description) Describes the macro. 
[Enter] 
4, (keys) Defines first portion of macro. 
5. [Alt]-# Nests in macro Alt-#. 
6. (keys) 


Defines the rest of the macro. 
1. (Ctrl]-[F10] Ends macro definition. 
Repeat steps 5 and 6 for each new nested macro. The Alt-letter 


nested macros must already exist before you can redefine the main 
macro. 


‘Repeat a named macro by pressing the [Esc] key, entering a 
repeat number, and executing the macro. Follow these steps: 


Key Sequence What it Does 

1. [Esc] Initiates repeat. 

2. # (enter any number) Sets repeat to that number of times. 
3. [Alt]-[F10] Invoke playback macro command. 
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4. {macroname} Enters macro to use. 
5. [Enter] Accepts the entry; macro is repeated 
number of times. 


°Create a repeating chain macro by having the macro call itself 
when it reaches the end. 


¢Complex macros should be drafted out on paper first using a flow 
chart design. This makes defining and troubleshooting macros 
easier. 
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CHAPTER 3 
MACRO EDITING 


L you don’t like the way a macro works after you create it, don’t 
start over—edit it. WordPerfect 5.0 has its own built-in editor which 
allows you to modify any macro. You can even create macros from 
scratch using the editor. 

You’ll learn the basics of editing macros in this chapter. You'll also 
discover how to reassign nearly any key on your computer to another 
function and how to create chained and nested macros while using 
the macro editor. The techniques you encounter in this chapter are 
used in the remainder of this book, and form the backbone of Word- 
Perfect power macros. 


ACCESSING THE MACRO EDITOR 


The macro editor is almost an "invisible" feature of WordPerfect. You 
cannot access it unless you attempt to redefine an existing macro. 
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Macro: Edit 
File SPHACROSNHELP. UPM 
1 - Description Hain menu help 


Z ~ action 


{CANCEL OFF} 

{ON ERRORHGOJerror~ 

CASSIG@D177 

CASS 1GN2787 

{CHAR} 8 Which: drive: contains: the: Supplement: Disk7: - 


{Retrieve}H{VAR 8}: help. txtCEnterthelp{Enter} 
{DISPLAY ON} 


{LABEL} start” 7 : 
(CHARL CN CP) Hake: a-selection-or- press: LF7]:to: quit: -{°O}C°P)~ 


Selection: 2 


FIGURE 3-1 SAMPLE MACRO EDITOR 


In that instance, WordPerfect prompts you that a macro with the 
name you have chosen already exists. You have three choices: 


*Replace the macro (start over): Press L 
¢Edit the macro: Press 2, 
¢Cancel the whole thing: Press 0. 


Pressing 2 reveals the macro editing window, as shown in Figure 
3-1. The contents of the macro is shown in the box. As detailed later 
in this chapter, you have a choice of editing the macro description 
(press 1) or editing the actual macro definition (press 2). The 
keyboard remapping window, which we will actually use first in this 
chapter, looks and behaves just like the macro editing window. 

Before we go head-first into a discussion of macro editing, let’s 
pause for a while and discuss some additional aspects of WordPerfect 
MACROS, as well as show how to create and edit macro-like 
keyboard definitions. 


DISPLAY CODES 
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Both the keyboard and macro editing windows display the meaning 
of the keys as codes. Most codes are self-explanatory, but if you find 
a code that is new to you, look it up on the following table: 


Key 


{Backspace} 
(Block) 

(Bold) 
(Cancel) 
(Center) 
(Date/Outline) 
(DEL to EOL) 
(DEL to EOP) 
(Del) 

(Down) 

(End) 

(Enter) 

(Exit) 

(Flush Right) 
{Font} 
(Footnote) 
(Format) 
{Goto} 
{Graphics} 
(Help) 
(Indent) 

(L/R Indent) 
(Left) 

(List Files) 
{Macro Commands} 
(Macro) 

{Mark Text) 
(Math/Columns) 
(Merge R) 
(Merge/Sort) 
(Merge Codes} 
{Move} 


Display Code In Macro 
Editing Window 
[Backspace] 
[Alt]-[F4] 

[F6] 

[F1] 

[Shift]-[F6] 
[Shift]-[F5] 
[Ctrl]-[End] 
[Ctrl]-[Page Down] 
[Delete] 


[Alt]-[F6] 
[Ctrl]-[F8] 
[Ctrl]-[F7] 
[Shift]-[F8] 
[Home] 
[Alt]-[F9] 
[F3] 

[F4] 
[Shift]-[F4] 
[Left] 

[F5] 
[Ctrl]-[Page Up] 
[Alt]-[F10] 
[Alt]-[F5] 
[Alt]-[F7] 
[F9] 
[Ctrl]-[F9] 
[Shift]-[F9] 
[Ctrl]-[F4] 
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(Page Down) (Page Down] 
(Page Up} [Page Up] 
(Print) [Shift]-[F7] 
(Replace) [Alt]-[F2] 
(Retrieve) (Shift]-[F10] 
(Reveal Codes} [Ajt]-[F3] 
(Right) [Right] 
(Save) [F10] 

(Screen) [Ctrl]-[F3] 
(Search Left} [Shift]-[F2] 
(Search) [F2] 

(Setup) (Shift]-[F1] 
(Shell) [Ctrl]-[F1] 
(Spell) (Ctrl]-[F2] 
(Style) [Alt]-[F8] 
(Switch) [Shift]-[F3] 
(Tab Align) [Ctrl]-[F6] 
(Tab) [Tab] 

(Text In/Out) [Ctrl]-[F5] 
(Thesaurus) [Alt]-[F 1] 
(Typeover] (Insert] 
(Underline) [F8] 

(Up) [Up] 

(Word Right) (Ctrl]-[Right] 
(Word Left} [Ctrl]-[Left] 


REMAPPING THE KEYBOARD 


WordPerfect 5.0 includes the ability to reassign, or remap, nearly 
every key on the IBM PC keyboard. This includes the alphabet and 
number keys, the function keys, even the cursor keys. While this 
may not seem an important feature at first, it’s one of the most con- 
structive because you can make WordPerfect behave like nearly any 
other word processing program. For example, you can reassign some 
of the control key characters to provide WordStar-like cursor move- 
ments. You'll see exactly how this is done later in this chapter. 

You can also change the definition of one or all of the function keys. 
Since I use the Reveal Codes key a lot, I prefer to have it readily 
available as the [F3] key instead of the standard [AIt]-[F3] key. 
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With the key remapping feature, it’s an easy process to switch the 
definitions of the two function keys. 

The key remapping feature is found as an option in the Setup 
menu. To remap a key, follow these initial steps: 


Key Sequence What it Does 
1. (Shift]-[F1] Chooses Setup menu. 
2.6 Selects Keyboard Layout option. 


At this point, you may either open an existing layout (if present) 
or create your own. If a key layout has been previously selected, it 
is shown with an asterisk, as depicted in Figure 3- 2. 

To Open An Existing Layout 


Key Sequence What it Does 

1. (cursor keys} Moves the cursor to the layout you want 
to use. 

2.5 Opens layout for editing. 


FIGURE 3-2 KEY REMAP SCREEN 


Setup! Keyboard Layout 


ACCOUNTS 
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1 Select: 2 Delete: 3 Rename: 4 Create; S Edit: 6 Original: N Name search 
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To Create a New Layout 


Key Sequence What it Does 
1.4 Creates a new, blank layout. 
2, name) [Enter] Names the new layout. 


Editing a Keyboard Layout 


Once the keyboard layout editing screen is displayed, you may edit 
any of the keys available, or else create new definitions. 
To create a new definition: 


Key Sequence What it Does 

1.4 Selects Create from the key edit menu. 
WordPerfect now prompts you to strike a 
key to reassign. 

2. (key) Selects a key to redefine. The keyboard 
edit screen automatically opens. 

To edit an existing key: 

Key Sequence What it Does 

1. (cursor keys) Moves the cursor to the layout you want 
to use. 

2.1 Opens key for editing. 

Editing the Keys 


The keyboard editing window is shown in Figure 3-3. Identify the 
purpose of the key by pressing 1, then type in a short description. 
Press [Enter] when you are through. To edit the key, press 2. The 
cursor is now placed inside the editing box. Display codes, as iden- 
tified in the previous section, are inserted for each key you press on 
the keyboard. To edit the definition, first delete the existing code by 
pressing [Del]. Then, insert the new codes by pressing the ap- 
propriate keys on the keyboard. 

The editing keys ([Delete], [Backspace], [Ctrl]-[End], etc.) 
work as they do in the WordPerfect main document window (the 
general exception is the [Ctrl]-[Page Down] key). But what if you 
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Key: Edit 
Key Ctrl-F 


1 - Description Ahead one word 


Z — Action 


{Word Right} 


Selection: 0 


FIGURE 3-3 KEYBOARD EDITING WINDOW 


want to include an editing key as part of a key definition? You have 
two choices: 


e Press [Ctrl]-V, then immediately press the editing key you want 
included. The definition for the desired editing key is placed in 
the box. After that, the editing keys revert to their normal opera- 
tion. 


¢Press [Ctrl]-[F10] to turn editing off. Now, every key you press 
is included in the assignment. None of the keys, including [F7] 
(Exit) or [F1] (Cancel) are operable. Press [Ctrl]-[F10] once more 
to turn editing back on. 


Since key assignments are really a form of macros, you have the 
full macro programming language arsenal at your fingertips. Al- 
though Chapter 4 details macro programming, the basic steps to 
writing elaborate macros are worth noting here. To access the 
programming statements, press [Ctrl]-[Page Up]. A pop-up win- 
dow appears. Use the cursor keys to scroll through the statements. 
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Add the one you want to the key assignment by selecting it, then 
pressing [Enter]. Press [Esc] to exit the pop-up window without 
making a selection. A description of the purpose and use of the 
programming statements appears in Chapter Four, “Macro 
Programming." 

To exit the key editing window, press [F7] twice. You are returned 
to the editing menu, where you may create or edit another key, or 
perform one of the functions below. Keyboard layouts you create are 
automatically saved as .WPK files. You can put the .WPK files on 
any disk or directory, but you must tell WordPerfect where to find 
them. Use the Location of Auxiliary Files option in the Setup menu 


and indicate a drive andor a directory. Your choice applies to both 
keyboard and macro files. 


Deleting Keys 


Key definitions you no longer want can be deleted by selecting them, 
then pressing option number 2. WordPerfect asks if you really want 
to delete the key assignment; if so, answer Y. Note that when you 
delete a key assignment, the original definition of the key returns. 


Moving Keys 


You may move definitions from one key to another. This prevents 
you from having to re-enter the definition of a key manually just be- 
cause you want to change it from [Ctrl]-L to [Ctrl]-C (the individual 
key reassignments are not stored in separate documents, so you can- 
not rename them from within WordPerfect or in DOS). 

To move a key, follow these steps: 


Key Sequence What it Does 

1. (cursor keys) Selects the key to move. - 
2.8 Chooses Move option. 

3. {key} 


Selects new key to hold the assignment. 
If the new key previously held an 
assignment, it is erased. 
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Saving Keys as Macros 


You may like a key assignment so much that you want to make it 
into its own macro. Or, more likely, you may want to share the as- 
signment with someone else who doesn’t want your entire assort- 
ment of remapped keys. You can save any key assignment in the 
following manner: 


Key Sequence What it Does 

1. (cursor keys} Selects the key assignment. 

2.5 _ Chooses Macro Save option. 

3. (name) Names the macro and saves it 
[Enter] on the disk. 


Assigning Macros to Keys 


If you have a macro that you want to integrate as a key definition, 
do the following: 


Key Sequence What it Does 

1.6 Selects Macro Retrieve option. 

2. name) [Enter] Indicates the macro you want to use. 
3. (key) Selects the key you want to hold the 


macro definition. 


Selecting a Keyboard Layout 


The changes you make to a keyboard layout are not activated until 
you choose the layout. Once you have created or edited all of the keys 
you want, follow this sequence: 


Key Sequence What it Does 

1.0 Leaves key editing menu, takes you back 
to keyboard layout menu. 

2.1 Selects the current layout (if the layout 


you want isn’t highlighted, press the 
cursor keys until it is). Pressing 1 exits 
the keyboard layout menu automatically. 
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3.0 Leaves the Setup command menu; you are 
back to the main document. 


Reverting to the Original Layout 


The changes you make to the key assignments have no permanent 
effect on WordPerfect. You may revert to the original standard 


keyboard layout at any time by pressing option 6 in the keyboard 
layout menu. 


Choosing a Keyboard Layout By Macro 


You can design macros that turn keyboard layouts on and off or 
choose others from the list. This is handy if you want to create key 
assignments that have different meanings depending on who’s using 
the program, or the kind of document you are currently editing. As 
an example, you can create a macro that turns the [Esc] key into a 
Cancel key at the start of an operation, then changes it back to its 
regular repeat function for the rest of the operation. 

Macros are essentially blind when they are executing, and they 
actuate keys precisely as you entered them. If you’ve added keyboard 
layouts to the list, you'll never know how many times to press the 
down arrow cursor key to select the one you want. Fortunately, the 
keyboard layout menu includes a name search function: 


Key Sequence What it Does 

1.N Selects name search function. 

2. {layout name} [Enter] Choose a layout. 

3.1 Selects the layout. 

4.0 Returns to the main document. 

Use this procedure in macros to choose a specific keyboard layout 
to use. 


Hands-On Key Editing—WordStar Equivalent Keys 


Here are key assignments that make some of the WordPerfect con- 
trol keys behave like WordStar cursor keys. Save these assignments 
in a layout called WORDSTAR (you can find the WordStar- 
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equivalent keys on the Applications Disk under the name 
WORDSTAR.WPE). 


Key Function Definition Keys to Press 
[(Ctrl]-A Word left {Word Left) [Ctrl]-[Left] 
[(Ctrl]-C Screen down (Screen Down} + (on keypad) 


[Ctrl]-D Right char. (Right) [Right] 
[Ctrl]-F Word right (Word Right) [Ctrl]-[Right] 
[Ctrl]-G Delete char. (Del) [Delete] 
[Ctrl]-R Screen up (Screen Up) - (on keypad) 
[Ctirl]-S Left char. (Left) [Left] 
[Ctrl]-T Delete word {Del Word) [Ctrl]-[Backspace] 
[Ctrl]-Y Delete line {Home} (Left) [Home][Left] 

{Del to EOL) (De]} 


Let’s review the process by creating the [Ctrl]-A key definition. A 
sample screen of the [Ctrl]-A keyboard editing box is shown in 


Figure 3-4. 
Key Sequence What it Does 
1. (Shift]-[F 1] Calls up Setup menu. 
2.6 Chooses Keyboard Layout option. 


FIGURE 3—4 CTRL-A EDITING BOX) 


Key: Edit 
Key Ctrl-A 


1 — Description Back one word 


Z — Action 


Selection: @ 
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3.4 Chooses Create option. 
4. WORDSTAR Names the keyboard layout 
[Enter] "WORDSTAR." (The WordStar layout 
automatically opens for editing). 
5.4 Chooses Create key option. 
6. (Ctrl]-A Names key as Ctrl-A. 
7. 1 Word Left key Describes key definition. 
[Enter] 
8. 2 [Delete] Brings cursor inside editing box and 
deletes existing key definition. 
9, [Ctrl]-V Inserts (Word Left) code. 
[Ctrl]-(Left] 


10. EN EN E7) 10 Exits keyboard layout editing, 
selectsWORDSTAR layout file, 
and returns to document editing. 


The WordStar “QR (beginning-of-document) and “QC (end-of- 
document) cursor keys are a little tougher to implement because it 
requires a two-step sequence. One way is to use WordPerfect’s 
programming language, as shown here. Later in this chapter, and in 
future chapters, you'll learn the syntax and use of these and other 
programming statements. The program is provided here only to 


show you what can be done with WordPerfect’s keyboard definition 
feature. 


(ASSIGN) 1~~ 
(LABEL) loop~ 
(VAR 1) 
(LOOK}1~ 


(IF)"(VAR 1)"="r"~(Home) (Home) (Up) (QUIT) 
(ELSE) 


(IF) "(VAR 1)"="c"~{Home}(Home} {Down} (QUIT) 
(ELSE) 

(END IF)(END IF) 

(GO)loop~ 


The completed definition, shown in the keyboard editing box, is il- 
lustrated in Figure 3-5. Pressing the [Ctrl] and Q keys invokes the 
key definition. 


The Applications Disk contains two additional keyboard layout 
files, QUIKKEYS.WPK and NEWFUNCT.WPK. 
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QUIKKEYS.WPK (in CHAPS directory on the Applications Disk) 
Provides the following functions: 


Key Description 
[F3] New Reveal Codes key. 
[F6] New Block key. 


[Alt]-[F3] New Move key. 

[Alt]-[F10] Macro key with APPDISK\ subdirectory prefix. 
[Ctrl]-C Alternate Copy block command. 

[Ctrl]-V Alternate Paste block command. 

[Ctrl]-X Alternate Cut block command. 

[Ctrl]-Z Alternate Cancel (Undo) 


NEWFUNCT.WPK (in CHAP3 directory on the Applications Disk) 
Provides the following functions: 


Key Description 

[Ctrl]-A Go to APPDISK subdirectory (on hard disk). 
[Ctrl]]-H_ Go back to main WordPerfect directory. 
[Ctrl]-P Quick print, draft 


FIGURE 3-5 CTRL-Q KEYBOARD MACRO 


Key: Edit 


Key Ctrl-Q 


1 - Description Control Q up/down 


2 — Action 


“="’p'"~{Home}CHome?CUp} CQUIT} 


"=""o''~{Home? CHome? (Down}CQUIT} 


Selection: B 
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[Ctrl]-S Quick save 
[Ctrl]-\ Help menu (when on current drive/directory) 


ASSIGNING VARIABLES 


Variables are handy programming tools that serve as temporary 
repositories of data. This data can be in the form of numbers, letters, 
or both. Chapter Four details variables in-depth, especially as they 
relate to programmed macros. 

WordPerfect can store up to ten variables; that is, it has ten spe- 
cial holding bays for text or numbers. These variables are assigned 
numbers from 0 through 9, and are accessed by pressing a number 
key with the [Alt] key. For instance, to choose the variable placed 
into slot number 4, press [Alt]-4. 

You'll have plenty of cause to use variables in more sophisticated 
programmed macros, but you can also use the feature to create up 
to 10 more temporary macros (in addition to the one that you can 
create with the [Enter] key). The limitations of variables are that 
they can contain numbers and text only, making them best suited 
for adding boilerplate text. You can’t code them with commands, cur- 
sor movements, or other keyboard functions. 

To assign a value to a variable: 


Key Sequence What it Does 


1. [(Ctrl]-[Page Up] Starts variable assignment procedure. 


The screen shows a Variable: prompt. 
Indicates the variable number you want 
to use (choose a single digit number 
between 0 and 9). The screen now shows 
a Value: prompt. 

Loads variable with your 


keystrokes. Press [Enter] to finish the 
definition. 


2. (number) 


3. (variable contents) 
[Enter] 


Note that (Ctrl]-(Page Up], also called the Macro Commands 
key, performs a different function when you are defining a macro 
than it does in the main editing window. 
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o Pressing [Ctrl]-[Page Up] while you are defining a macro from 
the keyboard brings up a function menu where—among other 
things—you can choose to add a pause to the macro or hide or show 
the display during execution. A full rundown of the command 
choices appears later in this chapter. 


o Pressing [Ctrl]-[Page Up] while you are editing a macro in the 
macro editing window provides access to WordPerfect’s advanced 
macro editing codes. 


The contents of the variables are erased when you assign them 
with a new value. All variables are lost when you exit WordPerfect. 
To experiment with variables, try the following: 


Key Sequence What it Does 

1. [Ctrl]-[Page Up] Invokes variable assign function. 

2-1 Selects variable 1. 

3. Macros are neat!! Enters the phrase "Macros are 
[Enter] neat!!" into the variable. 


To play back the variable, press, [Alt]-1. WordPerfect will spill out 
Macros are neat!! 


on the screen. 


MACRO EDITING 


All macros can be edited using WordPerfect’s built-in macro editor 
(the macro editor was a separate program in version 4.2). As men- 
tioned earlier in the chapter, to access the macro editor you must 
redefine an existing macro. WordPerfect responds that the macro al- 
ready exists, and asks if you want to replace the existing macro or 
edit it. 


eTo cancel redefining the macro, press 0. 
eTo replace the macro and start over, press 1. 


eTo edit the macro, press 2. 
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You are then placed in the macro editing window. The contents of 
the macro appears in the editing box. 


Editing the One-Line Description 


The one-line description provides a quick reference to the purpose 
of the macro. You can edit or delete it at any time: 


Key Sequence What it Does 
11 Places the cursor in the description field. 


2. (keys) Edits the description; the editing keys 
function as they normally do in 
WordPerfect. With the cursor positioned 
at the first character, typing anything 
erases the entire line. 
3. [Enter] Finishes the definition. 
Editing the Macro 


Follow these steps to edit a macro: 


Key Sequence What it Does 

1,2 Places the cursor in the macro box. 

2. (keys) Edits the macro; the editing keys function 
as they normally do in WordPerfect. 
When done, proceed to step 3. 

3. EN 


Moves the cursor outside the editing box 
(you can now leave the editing window, 


edit the definition, or enter back into the 
editing box). 


To leave the editing window, press [F7] again or press 0. When 
not actually editing a definition or macro, pressing a key other than 


1 or 2 while in the macro editing screen brings you back to 
WordPerfect’s main document window. 
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Controlling Editing Keys 


While working inside the macro editing box, the editing keys— 
[Backspace], [Delete], [Enter], etc.— function as they normally 
do in WordPerfect. If you want to place the definitions of these keys 
in the macro, do one of the following: 


o Press [Ctrl]-V, then immediately press the editing key you want 
included in the key assignment. After that, the editing keys revert 
to their normal operation. Example: [Ctrl]-V [Enter] places an 
{Enter} code in the macro. 


o Press [Ctrl]-[F10] to turn editing off. Now, every key you press 
is included in the assignment. Press [Ctrl]-[F10] once more to 
turn editing back on. 


Note that pressing the [Tab] key tabs a line of macro code over 
approximately five spaces, and that pressing the [Enter] key drops 
the code down one line. The visual effect of these keys in the macro 
editing box does not relate to the operation of the macro. Adding four 
or five blank lines between segments of macro code does not produce 
four or five blank lines when the macro is executed. 

To add Tab and Enter codes that are applied to the document 
during execution, enter them explicitly using one of the methods out- 
lined above. Examples of using the [Tab] and [Enter] keys are 
shown in Figure 3—6 

Other than adding and deleting pieces of macro code, the editor is 
very crude and does not currently allow you to copy a segment of code 
from one part of the box and paste it into another. If you find you 
need to move a segment of code to another area of the macro, make 
a note of it and manually retype it. Double check that you have re- 
entered the code exactly as the original, then erase the original. 

You can, however, include the text of an Alt-letter macro by run- 
ning the macro during editing. For example, suppose you are edit- 
ing a macro for preparing a boilerplate customer reply letter. You 
have a large paragraph that you don’t want to retype. Position the 
cursor in the editing box where you want the text to appear, then 
press [Alt] and the appropriate letter. The Alt-letter macro executes, 
as normal, and its text is entered into the new customer reply macro. 
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Macro! Edit 
File TEST. UPH 
1 — Description 


Z — Action 


{Tab}You’ 11-learn-all- about: neu. computer: system: that: has-been: 


installad-by-the-IS-C Information: Systems) :department, -and:what-you- 
need: to: know: to: make: it-work:for- you. (Enter? 
{Enter} 
{Tab}Bring-a:lunch- and: plan-to-stay:all-day.:-Snacks:and:soda: pop: 
are:on: the: house, (Enter) {Enter} 

Yes,:I-can:come{Tab} Sorry,:I: have’ a-prior: 


Selection: Z 


FIGURE 3-6 USING TAB/ENTER FOR COMMENTED, ACTUAL TEXT 
FIGURE 3-7 RESULT OF USING TAB/ENTER 


Saturday is THE big day at the employes forun! 


You’l1 learn all about new computer system that has been 
installed by the IS (Information Systems) department, and what 
you need to know to make it work for you. 


Bring a lunch and plan to stay all day. 


S 
are on the house. MAE AERO 


Yes, I can come Sorry, I have a prior engagement. 


Doc 1 Pg 1 Ln 11 Pos 12 
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Note that this technique only works with Alt-letter macros. If the 
macro you want to use isn’t an Alt-letter macro, you can easily con- 
vert it simply by renaming it. Press [F5] and, if necessary, select the 
drive and directory that holds your macros. Find the macro you want 
to rename and select it. Press 3, for Move/Rename, and choose an 
Alt-letter combination that’s not already in use, such as 
ALTM.WPM. Exit List Files by pressing 0, then press [Alt]-M (or 
whatever). The macro should execute normally. 

Another important point: WordPerfect will act "dead" if you try to 
load the contents of an Alt-letter macro when that macro starts with 
a {DISPLAY OFF) code (WordPerfect automatically adds this code 
to all new macros it creates, but never adds the {DISPLAY ON) code 
at the end). You need to remove the (DISPLAY OFF) code from the 
Alt-letter macro before you use it. If you forget to do this, press [F1] 
to cancel the operation and WordPerfect will come back to life. 


CHAINING AND NESTING MACROS WHILE 
EDITING 


Recall from Chapter 2 the difference between a chained and a nested 
macro. In a chained macro, WordPerfect starts the first macro and 
executes it to completion. At the end of the macro is an instruction 
to chain or branch off to another macro. WordPerfect then starts that 
macro. Once a macro has been chained, WordPerfect forgets about 
the previous one and concentrates only on the current one. 

In a nested macro, WordPerfect executes the first macro, then— 
when it encounters the nesting instruction—temporarily branches 
off to another one. When the second macro is finished, the program 
returns to the first macro. 

The technique described in the previous section does not actually 
produce a chained or nested macro. It reinserts the text from one 
macro into another one. If you want to program a chain to another 
macro, go to the end of the current macro and insert the chain in- 
struction. 


To Chain to A Named Macro 


Chaining to a named macro is the easiest of all. These steps assume 
you are currently editing a macro: 
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Key Sequence What it Does 

1, [Alt]-[F10] Enters (Macro} code. 

2. (name) Enters the name of the macro you want 
to chain to. 

3. [Ctrl]-V Places the editor out of edit mode for the 
next keystroke only. 

4, [Enter] Places an (Enter) code in the macro. 


To Chain to An Alt-Letter Macro 


Chaining to an Alt-letter macro requires that you enter the code of 
the [Alt]-letter key and not the actual contents of the macro. These 
steps assume you are editing a macro. 


Key Sequence What it Does 
1. [Ctrl]-[F10] Turns editing off (don’t forget this step). 
2. [Alt]-{letter) Enters the name of the Alt- letter macro 


you want to chain to. 
3. (Ctrl]-[F10] Turns editing back on. 


FIGURE 8-8 CHAIN-TO MACROS FOR NAMED AND ALT 


Macro: Edit 
Fila CHAIN. UPM 
1 ~- Description 
Z —- Action 
Start: of-the-macro, 


This>chains: to-a-named-macro. 
{Macro}chained{Enter} 


Start: of-the- macro 


This-chains: to-an- Alt-letter- -MACrO, 
{ALT A} 
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Examples of both methods are shown in Figure 3-7. Note that 
when editing is off (by pressing the [Ctrl]-[F10] keys), pressing the 
[Delete] and [Backspace] keys actually enter (Delete) and (Back- 
space) codes in the macro. You probably don’t want these; take them 
out by temporarily returning to edit mode (press [Ctrl]-[F10] again) 

Placing an Alt-key code at the end of a macro causes WordPerfect 
to chain to the Alt-letter macro after executing the first one. You can 
create a nested macro by entering the {ALT#) code anywhere inside 
the body of the macro. Now, when WordPerfect starts the first macro, 
it temporarily branches off to the Alt-letter macro at the point you 
have specified. When the Alt-letter macro is finished, the program 
returns to the original macro. You may repeat this procedure any 
number of times you wish. 

Repeat the steps specified above for chaining with Alt-letter 
macros. Be sure to press the [Ctrl]-[F10] key first (to turn editing 
off), or WordPerfect will load the contents of the Alt-key macro into 
the macro you are editing. You know you have successfully entered 
the code for the Alt-key macro when you see the (ALT#) code in the 
editing box. 


IMPORTANT TOPICS 


eTo edit a macro you must redefine an existing one. WordPerfect 
warns you that the macro already exists. Respond by pressing: 1 
to replace the macro, 2 to edit the macro, or 0 to quit and go back 
to the main document window. 


¢WordPerfect lets you remap nearly every key on the IBM PC 
keyboard. 


To remap a key using an existing keyboard layout: 


Key Sequence What it Does 

1. [Shift]-[F1] Opens Setup menu. 

2.6 Selects Keyboard Layout option. 

3. (keys) Selects the layout file you want to use. 
4.5 Selects Edit. 

5. 4 Selects Create from the key edit menu. 


WordPerfect now prompts you to strike a 
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6. (key) 


1.2 


key to reassign. 

Selects a key to redefine. The keyboard 
edit screen automatically opens. 

Places cursor in key editing box. 


‘Key assignments can be stored as separate macros or they may 
be created from an existing macro. 


¢WordPerfect has 10 variables, which are accessed by pressing a 
number key with the [Alt] key. 


eTo assign a variable to a number while not defining or editing a 


macro: 


Key Sequence 
1, [Ctrl]-[Page Up] 


2. (number) 


3. (variable contents) 


[Enter] 


What it Does 

Starts variable assignment procedure. 

The screen shows a Variable: prompt. 
Indicates the variable number you want 

to use (choose a single digit number 
between 0 and 9). The screen now shows a 
Value: prompt. 

Loads variable with your 


keystrokes. Pressing [Enter] finishes the 
definition. 


eTo edit a macro, press [Ctrl]-[F10] and type its name. Press 2 to 
choose Edit. You are then placed in the macro editing window. 
Press 1 to edit the description of the macro; 2 to edit the macro 


definition. 


CHAPTER 4 
MACRO PROGRAMMIN 


Being able to record a series of keystrokes for later recall is power 
enough, but WordPerfect’s macro feature also includes a method of 
programming your macros so that they behave like stand-alone ap- 
plications. With just a little bit of ingenuity, you can create macros 
that create, from scratch, a complete invoice for services or products, 
an electronic while-you-were-out telephone note pad, a "RAM-Resi- 
dent" note pad, a mini calculator, a self-testing and scoring quiz 
game, a text adventure game, and much more. In short, there is al- 
most no limit to what you can do with WordPerfect’s macro program- 
ming language. | 

This chapter explains how to access the programming feature of 
macros and the meaning of the various programming "statements," 
or instructions. This chapter does not delve into actually employing 
the various programming statements in real macros—the rest of the 
book is devoted to that. Ifyou are serious about macro programming, 
be sure to read Chapter 16, "Macro Strategies," and Chapter 17, 
“Macro Debugging." These chapters provide additional insights on 
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insights on applying the macro programming language, as well as 
how to avoid its frustrating pitfalls. 


THINKING LIKE A PROGRAMMER 


Although you don’t need any previous training or experience at com- 
puter programming to master WordPerfect’s programming lan- 
guage, it does help. At the very least, you should learn how to think 
like a programmer. One of the first things a programmer does when 
starting a project is to map out the individual segments, or 
"routines," that make up the software. Even the longest, most com- 
plex program—and this includes macros—consists of little more 
than bite-size routines. The macro progresses from one routine to 
the next in an orderly and logical fashion. 

As illustrated in Figure 4—1, most macros start at the beginning 
and advance one step at a time to the end, taking each instruction 
in turn and acting upon it. But some WordPerfect macros jump 
around. They may start with routine 1, but then jump to routine 3, 
back to 1, then move on to 2. 

Depending on the application of the macro, it may behave one way 
when used with a particular type of document, and behave in a to- 
tally different way with another document. This concept may take 
some time to get used to, but it lends a great deal of power and 
flexibility to your macros. Instead of your macros conforming to a 


strict procedure, they are free to interact and adapt with your docu- 
ments. 


FIGURE 4-1 


second first 


STEP ONE 


STEP ONE 


t 


STEP TWO 


Y 


STEP THREE 


STEP TWO 
stop 


STEP THREE 


Macro 1 Macro 2 
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WordPerfect macros don’t use line numbers, as found on some 
other programming languages, such as BASIC. You identify routines 
by name, or label. When you instruct WordPerfect to jump from one 
routine to another, you tell it which label to go to. Of course, if your 
macro is designed to go from beginning to end without stopping, you 
don’t need labels, but it’s still a good idea to think of the construc- 
tion of the macro as discrete routines. 

Programmers dearly love subroutines. These are routines that the 
macro branches off to temporarily, in order to accomplish some task 
or to wait until a certain condition is met. When the subroutine ends, 
the macro automatically jumps back to where it left off. Like a 
routine, a subroutine consists of a label (so the macro can find it), 
but it also has a Return identifier. The Return marks the end of the 
subroutine, and instructs the macro to go back to where it first left 
off. 

A common programming term is "string." A string is simply a se- 
quence of letters and numbers. In the context of macros, strings are 
used in variables—temporary repositories of information. Once 
stored in a variable, the string can be acted upon by the macro. For 
example, if the string is a number, you can multiply it with another 
number or the numeric contents of another variable. If the string is 
text, you can compare it with another string to see if the two are the 
same. The concept of comparing strings comes in handy when design- 
ing interactive macros. The advanced macros in Part Two of this 
book rely heavily on comparing strings. 


PROGRAMMING MACROS 


WordPerfect’s macro programming language is available while in 
the macro editing window (the same programming statements are 
also available in the key layout window; key definitions are the same 
as macros). To access the programming statements while editing a 
macro, press [Ctrl]-[Page Up]. A pop-up menu appears over the 
editing box, as shown in Figure 4—2. Use the up and down arrow keys 
to scroll through the contents of the programming menu. You can 
quickly shuttle to a particular statement by typing the first couple 
of characters in its name. 
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Macro! Edit 


{;}comment~ 
CASS IGN}variable~value™~ 


File TEST. UPM 


1 — Description 


{Tab}Saturday: is. THE- big-day-at- the: employes: forum? {Enter} 
{Enter} 
{Tab}You’ ll-learn:all-about- neu: computer: system: that: has-been: 
installed-by: tha: IS:( Information: Systems): department, -and:uhat: you: 
need: to: know: to-make-it- work: for: you, {Enter} 

{Enter} 

{Tab} Bring-a:lunch-and-plan-to-stay:all-day. --Snacks:and: soda: pop: 
are:on: the- house. (Enter) CEnter} 

Yes, -I-can-come{Tab} Sorry,-I-have-a-prior: 


(Name Search: Enter or arrous to Exit) 


FIGURE 4-2 POP-UP PROGRAMMING STATEMENTS WINDOW 


Each statement, such as (DISPLAY ON) and (CHAIN), is enclosed 
in brackets. Some statements are followed by one or more argu- 
ments. These arguments tell WordPerfect what to do with the state- 
ment. For example, the (CHAIN) statement is followed by a macro 


file name argument. To complete the statement in an actual macro, 
you'd enter: 


{CHAIN} filename~ 


WordPerfect uses the tilde character (~) as a delimiter. The 
program knows that the argument is done when it reaches the tilde, 
and that it should expect text or another macro code to follow. 

To enter a statement into a macro, select the one you want with 
the cursor keys until it is highlighted, and press the [Enter] key. 
The statement appears in the macro editing box. You DO NOT in- 
clude macro statements by typing them letter for letter from the 
keyboard. Note that the text for the argument is not included, only 
the statement itself, and that the statement is shown in bold. You 
may exit the pop-up menu without making a selection by pressing 
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the [Esc] key. If you press [Ctrl]-[Page Up] again, WordPerfect 
reselects the macro statement that you last used. This allows you to 
enter a series of the same statements in the macro editing box quick- 


ly. 


MACRO LEVELS 


Macros have many levels of execution. You can think of the levels of 
execution as levels in an underground parking garage, as illustrated 
in Figure 4—3. The top level marks the main macro. When the macro 
branches off to a subroutine (using the (CALL) and (CASE CALL) 
instructions, as detailed below), WordPerfect steps down a level. 
After the subroutine is over, WordPerfect drives back up to the top, 
main level. 

The same thing happens when you branch to a nested macro. 
While executing the main macro, WordPerfect is at the top level. 
When the program branches off to the nested macro, it goes down 
one level. Conversely, when WordPerfect returns from the nested 
macro, it goes back up to the top level. 

WordPerfect supports up to 20 levels of macro execution. That is, 
you can go down 20 levels before bottoming out. Subroutine levels 
are nested within one another; the macro receives another instruc- 
tion to go down to the next lower subroutine level before it has a 


FIGURE 4-3 PARKING GARAGE ANALOGY OF MACRO LEVELS 
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chance to come back to the top. Similarly, nested macros can branch 
off to other nested macros without first returning to the top. 

Each (CALL) or (CASE CALL} subroutine represents one level of 
execution. That means you can nest subroutines up to 20 deep. Each 
nested macro represents two levels of execution, so you can nest 
macros only 10 deep. 

The concept of levels is an important one because some of 
WordPerfect’s programming instructions are level sensitive. For ex- 
ample, if an error occurs in a lower level subroutine or nested macro, 
WordPerfect reports the error to the next higher subroutine or 
macro. There, the program hopes to find a command that tells it what 


to do if an error occurs. If no command can be found, all macro ex- 
ecution stops. 


DEFINITION OF MACRO STATEMENTS 


The example macros presented in Part Two of this book rely heavi- 
ly on macro programming statements (also sometimes called 
keywords or instructions). You will learn, first hand, how to use the 


statements in actual macros. As a reference, the following is a sum- 
mary of all macro statements and what they do: 


{:} comment~ 


Used to document a macro; the text before the tilde delimiter is ig- 
nored during execution. 


Example: (;)This section checks to see if the Enter key is pressed, 
then continues on.~ 


{ASSIGN} variable~value~ 


Assigns a value to a variable. 

Example: (ASSIGN) 1~1000~ 

Assigns the number 1000 to variable number 1. 

Variables can contain text or whole numbers. When entering frac- 
tional numbers, or those with non-numeric characters, WordPerfect 
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treats the value as text. Programmers who are used to working with 
high-level computer programs such as BASIC may find the ASSIGN 
command—and WordPerfect variables in general—difficult to get 
used to. Unlike BASIC, WordPerfect assigns variables by number in- 
stead of by an arbitrary name. 


{BELL} 


Produces a short tone through the computer’s speaker. Used without 
an argument. 


{BREAK} 


Moves the macro to the end of an IF... .ELSE structure. If an IF 
.. -ELSE structure doesn’t exist, it ends the macro. Used without an 
argument. 


{CALL} label~ 

Calls a subroutine inside the current macro. After the subroutine is 
finished, the macro returns to the point immediately after the 
(CALL) statement and continues on. Each (CALL}ed subroutine 
must end with a (RETURN} statement. 


Example: {CALL}loop~ 
Calls the subroutine that begins with the label "loop." 


{CANCEL OFF} 


Inhibits the use of the Cancel key. Used without an argument. 


{CANCEL ON} 


Allows the use of the Cancel key. Used without an argument. 
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{CASE}value~casel~labell~...case#~label#~~ 


Checks the value and compares it against each case in the argument 
string. If the macro finds a match, WordPerfect branches off to the 
corresponding label. You can use any number of case/label argu- 
ments that you wish. Remember to end the (CASE) statement with 
two tildes—one tilde is the delimiter for the last label, and the other 
tilde is the delimiter for the (CASE) instruction. 

Example: (CASE)4~10~end~4~start~~ 

Compares the value 4 against cases 10 and 4. Since case 4 is a 
match, it goes to the corresponding label, named "start." 


{CASE CALL} value~casel~labell~...case#~label#~~ 


Same as (CASE), above, but calls the subroutine identified with the 
corresponding label. After the subroutine is finished, the. macro 
returns to the (CASE CALL} statement and continues on. Each 
(CASE CALL)ed subroutine must end with a (RETURN) statement. 


{CHAIN}macro~ 


Executes the named macro, leaving the current one. 
Example: (CHAIN) dolist~ 
Immediately branches off to a macro named "dolist." 


{CHAR} variable~message~ 


Prompts you with the message and stores the next keystroke you 
type in the variable indicated. Causes a pause in the macro; the mes- 
sage stays until you press a key. 

Example: (CHAR)0~Type Y or N.~ 

Assigns the next keystroke (Y or N) to variable 0. 


{DISPLAY OFF} 


Turns the display off during macro execution. Used without an ar- 
gument. 
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{DISPLAY ON} 


Turns the display on during macro execution. Used without an ar- 
gument. 


(ELSE) 


Used with the (IF) and (END IF) statements. Indicates what should 
happen if the {IF) statement is false. Should the (IF) instruction be 
true, (ELSE) terminates the IF...ELSE structure (put another way, 
instructions following (ELSE) are NOT executed when the {IF} in- 
struction is true). See the description of (IF} for an example of how 
the (ELSE) statement is used. 


{END IF) 


Ends the IF...ELSE structure. See the description of {IF) for an ex- 
ample of how the (END IF) statement is used. 


{Enter} 


[Enter] key code, executed within the macro. Normally, pressing the 
[Enter] key inserts a comment only. Press [Ctrl]-V, then [Enter] 
to insert an (Enter) code in the macro. The (Enter) code produces a 
hard return in the document (or in the status line message if used 
in a (TEXT), (CHAR), or (PROMPT) string). 


{GO}label~ 


Goes to the named label inside the current macro. You can go to 
labels that are in front of or behind the (GO) statement. 

Example: (GO)testrun~ 

Goes to the label identified as "testrun." 

Label names can only be used once in a macro. The names can use 
any characters and can be any length. To avoid typing errors, 
however, try to limit label names to one or two short words. 
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{IF} value~ 


If the value is true, performs the very next command or jumps to the 
point after the (END IF) instruction (see Figure 4—4). If the value is 
false, goes to the command immediately after the (ELSE) instruc- 
tion. 


Example 1: ({IF){(VAR 0}=10~(GO)start~ 
(ELSE) (QUIT) 
{END IF} 
Example 2: {IF)(VAR 0}=10~ 
(ELSE) (QUIT) 
{END IF) 
(GO}start~ 


Both examples do the same thing. If the value in variable number 
0 is equal to 10 (true), go to the label named "start." If the value in 
variable 0 is not equal to 10 (false), quit the macro. 

Note that the equal sign is not the only operator you can use with 
the (IF) statement, although it is the most common. You can also test 
for not equal to, greater than, less than, and others. See the section 


called Assigning Values to Variables, below, on WordPerfect’s 
operators. 


FIGURE 44 IF INSTRUCTION 


Instructions performed 
when statement is TRUE 


(IF}{VAR 1}=100~[TRUE] 
{ELSE} [FALSE] 


{ END IF } x Instructions performed 
[TRUE] when statement is FALSE 


Instructions performed 
hen statement is TRUE 
(altemate location) 
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(IF EXISTS} variable~ 


If the variable has something in it (text or numbers), then the IF in- 
struction is true. If the variable is empty (undefined), then the IF 
statement is false. It follows the same logic described above for the 
(IF) statement. 


Example: (IF EXISTS)0~ 
(ELSE) (QUIT) 
(END IF) 
(GO)}start~ 


If variable number 0 has something in it (true), skip to the next 
instruction after (END IF} (in this example, there is nothing im- 
mediately after the {IF EXISTS) statement, so the macro jumps to 
the end of the IF... .ELSE structure). If the variable is empty, quit 
the macro. 


{LABEL} label~ 


Identifies the label with a name. Used with (GO), (CALL), (CASE), 
and {CASE CALL) statements. Text or macro commands after the 
label are executed. 


Example: {LABEL}start~ 
This is the text for the "start" routine. 
Identifies the label as "start." 


{LOOK} variable~ 


Scans the keyboard and assigns the next keystroke to the variable. 
If a key isn’t pressed, continues on with the macro. Most often used 
with a repeating loop to check continually for key presses. 


Example: (LOOK)1~ 
Assigns the next key pressed to variable number 1. 
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{NEST} macro~ 


Nests the named macro. After the named macro finishes, Word- 
Perfect returns to the original one and continues execution where it 
left off. 

Example: {NEST)dolist~ 

Temporarily branches off to a macro named “dolist." 


{ON CANCEL} command~ 


If the [Cancel] key is pressed, or a macro encounters a cancel from 
within itself or in a nested macro, this statement indicates what 
should happen next. The default instruction, when no {ON CANCEL} 
statement is provided, is RETURN CANCEL. 

Example: {ON CANCEL) (RESTART) ~ 

When Cancel is encountered, the (RESTART) instruction ter- 
minates all macro execution at the end of current subroutine or 
nested macro. 


Only a limited number of programming instructions are allowed 
with (ON CANCEL): 


¢(BREAK) 

e (CALL) 

° (GO) 

° (QUIT) 

° (RESTART) 

* (RETURN) 

e (RETURN ERROR) 

e (RETURN NOT FOUND) 


IF no instruction is included with the (ON CANCEL) statement, 
it is ignored and the macro continues. The {GO} and (CALL) state- 
ments require arguments of their own, which need a tilde as a 
delimiter. When used with these statements, you must provide two 
tildes at the end of the (ON CANCEL) instruction, such as {ON 
CANCEL){GO}label~~. 
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{ON ERROR} command~ 


Tells WordPerfect what to do if an error is detected during macro 
execution. The error can occur in the macro, in WordPerfect, or in 
DOS. The default command, when no (ON ERROR} statement is in- 
cluded, is RETURN ERROR. The syntax and use is the same as with 
(ON CANCEL). 


{ON NOT FOUND}command~ 


Tells WordPerfect what to do if a search ends with a *not found* 
message. The default command, when no (ON NOT FOUND) state- 
ment is included, is RETURN NOT FOUND. The syntax and use is 
the same as (ON CANCEL). 


{ORIGINAL KEY} 


Echoes the key you last typed. Typically used to pass a keystroke 
from one macro to another; best when used with Alt-letter macros. 
The value of key is the original version. That is, if you have reas- 
signed the [Esc] key to something else, WordPerfect still echoes back 
the original definition for the [Esc] key. The (ORIGINAL KEY} 
statement is used without an argument. 


{PAUSE} 


Pauses macro execution. Press [Enter] to restart. Used without an 
argument. 


[PROMPT] message~ 


Displays the message in the status line. The (PROMPT) statement 
must be nested in a loop or pause, or the message will only flash on 
the screen and disappear as the macro continues execution. You can 
also keep the prompt message on the screen during the execution of 
a long macro by turning the display off. However, you must be sure 
to move the prompt message up a line, as detailed in Control Charac- 
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ters, below, or the *waiting* message that appears during macro ex- 
ecution will erase the prompt massage. 


Example: (PROMPT)When you are ready, press Enter and the 
macro will begin.~ 


{QUIT} 


Terminates all macro execution. Used without an argument. 


{RESTART} 


Stops all macro execution (including nested macros) at the end of the 
current subroutine or nested macro. Used without an argument. 


{RETURN} 


Used with the (CALL) and (CASE CALL) instructions. Marks the 
end of a subroutine. When (RETURN) is encountered, the macro 
jumps back to the point immediately after the (CALL) or (CASE 
CALL) instruction. When {RETURN} is placed by itself without a 
subroutine, it terminates the macro (used most often in this applica- 


tion to return from a nested macro, as shown in Figure 4— 5). The 
(RETURN) statement is used without an argument. 


FIGURE 4-5 RETURN FROM NESTED MACRO 


{ CALL} subroutine~ (CALL) instruction 
(rest of macro) Pa ole 
{ LABEL} subroutine~ 


(RETURN) instructions i 
jumps back to end of (subroutine) 
(CALL) samen __ {RETURN } 
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{RETURN CANCEL} 


Returns from a subroutine or nested macro and indicates a cancel 
condition to the main routine or macro. Used without an argument. 


{RETURN ERROR} 


Returns from the subroutine or nested macro and indicates an error 
condition to the main routine or macro. Used without an argument. 


{RETURN NOT FOUND) 


Returns from the subroutine or nested macro and indicates a not 
found condition to the main routine or macro. Used without an ar- 


gument. 


{SPEED} 1/100th secs.~ 


Slows down macro execution by the indicated amount, or waits the 
amount of time indicated between each key input. 

Example: (SPEED})50~ 

Slows down macro execution by an extra 50/100ths (or 1/2) of a 


second. 


{STATE} 


Returns a number that represents the current operating state of 
WordPerfect. The number is in binary form and adds together if more 
than one state applies. 


State 

Number Condition 

1 Document 1 current 

2 Document 2 current 

3 Document 3 (special) current 
4 Main editing screen 
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8 Editing structure other than main screen 
16 Macro definition active 

32 Macro execution active (always on) 

64 Merge active 

128 Block active 

256 Typeover active 

512 Reveal Codes display active 

1024 Yes/no prompt active 


: Example: (STATE)—assuming document 1, block active, and 
typeover active—prints out the number 421 (1+4+32+128+256). 
You can check for specific conditions using the AND logical 


operator, expressed as "&". For example, (STATE)&256 checks to see 
if typeover is active. 


elf typeover is on, the number is 256. 
e If typeover is off, the number is 0. 


The (STATE) instruction is not used with an argument, but is 
often coupled with other programming statements. You can combine 
the (STATE) instruction with {ASSIGN}, (F), (CASE), and (CASE 


CALL) statements. The instruction (ASSIGN]1~(STATE)~ assigns 
the (STATE) number to variable number 1. 


(STEP ON) 


Slows down macro execution to one step at a time. You manually ad- 
vance the macro by pressing a key. You can cancel the macro at any 
time by pressing [F1]. During stepping, the contents of the macro 
appear in the status line. Text is shown normally, but programming 
statements are given command numbers. These numbers are 


detailed in Chapter Seventeen. (STEP ON) is used without an argu- 
ment. 


{STEP OFF} 


Turns stepping off. Used without an argument. 
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{Tab} 


Tab key code, executed with the macro. Normally, pressing the [Tab] 
key inserts a comment. Press [Ctrl]-V, then [Tab] to insert the (Tab) 
code. The {Tab} code produces a tab in the document. 


{TEXT} variable~message~ 


Prompts you with the message and stores your keystrokes in the 
variable. The instruction ends when you press [Enter]. Each vari- 
able can hold a maximum of about 128 characters. 

Example: {(TEXT)7~Enter name and address.~ 

Displays "Enter name and address" and stores the answer in vari- 
able number 7. 


{WAIT} 1/10th secs.~ 
Waits the specified period of time before continuing. 


Example: (WAIT)15~ 
Waits 1.5 seconds (15/10ths) then continues. 


CONTROL CHARACTERS 


These display-control characters may be placed inside {CHAR}, 
(PROMPT), and (TEXT) messages. 


Character Displayed As Function 


AH (Home) Positions cursor to upper left corner 
of the screen. 

^J (Enter) Enters new line. 

AK (DEL TO Deletes to end of the current line. 
EOL) 

AL (DEL TO Deletes to the end of the current page. 
EOP) | 

^M (^M) Positions cursor at beginning of line. 

AN (^N) Turns on display attribute (See Font 


Attribute Characters, below). Follows 
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^O 
AP 


^Q 
AR 
AS 
AT 
AU 
Ay 
AW 
AX 
AY 
^Z 
^l 
AN 


(^0) 
(^P) 


(^Q) 
(^R) 
(^S) 
(^T) 
(AU) 
(^V) 
(Up) 
(Right) 
(Left) 
(Down) 
(^) 
(^\) 


with display character. 

Turns off display attribute. Follows 
with display character. 

Positions cursor to row and column 
(one character each). 

Turns off all display attributes. 
Turns on reverse video. 

Turns off reverse video. 

Turns on underline. 

Turns off underline. 

Turns on mnemonic attribute. 
Positions cursor up one line. 
Positions cursor right one character. 
Positions cursor left one character. 
Positions cursor down one line. 
Turns on bold. 

Turns off bold. 


An example of a status line using embedded control character text 
is shown in Figure 4—6. Chapter 16, "Macro Strategies," gives more 
details on using control characters in message strings. 


FONT ATTRIBUTE CHARACTERS 


These special font-attribute characters can be placed after the ^N 
Display On code (see above). To cancel an attribute character, enter 
AO, then the character you want shut off. Note that some text at- 
tributes may not be visible on the screen when using a monochrome 
display adapter or Hercules monographics card. 


Character Displayed As Function 


AA 
AB 
AC 
AD 
^E 
AE 
^G 


(^A) 
(^B) 
(^0) 
(^D) 
(^E) 
(^F) 
(^G) 


Very large text. 
Large text. 
Small text. 
Small print text. 
Superscript text. 
Subscript text. 
Outline text. 
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Macro: Edit 
File DISPLAY. WPM 
1 - Description 


2 — Action 


{PROMPT} 

{“T}This: is: underlined: text. {(*U} {Enter} {Enter} 
{(“R} This: is- reverse: video- text. (*S}{Enterd 

{Home} This: is-text-uritten:at:top: left-of-screen.~ 


Selection: 2 


FIGURE 4-6 CONTROL CHARACTER TEXT—PROGRAM 


FIGURE 4-7 CONTROL CHARACTER TEXT—RESULT 


This is text uritten at top left of screen. 


This is underlined text. 


This is reverse uideo text. 
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AH (Home) Italics text. 

Ay (Tab) Shadow text. 

AJ (Enter) Redline text. 

AK (DEL TO Double underline text. 
EOL} 

AL, (DEL TO Bold text. 
EOP) 

^M (^M) Strikeout text. 

AN (^N) Underline text. 

AO (^0) Small caps text. 

AP (^P) Blinks text on and off. 

AQ (^Q) Reverse video text. 


ASSIGNING VALUES TO VARIABLES 


You can assign a value to one of WordPerfect’s 10 variables in any 
of four ways: 


e Directly from the keyboard. As you learned in Chapter 3, "Macro 
Editing," press [Ctrl]-[Page Up] (the Macro Commands key) 
during normal editing and you are prompted for the variable num- 
ber. Press one of the number keys; you are then prompted for the 
value. The value can be letters, numbers, or both. Press [Enter] 
when you are done. Play back the contents of the variable by press 
[AIt] and the variable number. 


eWhile editing a macro. Use the (ASSIGN) programming state- 
ment as detailed earlier in this chapter. Although ASSIGNed vari- 
ables are most often used with other instructions in the macro, 
you can play back the contents in the same manner as described 
above. Simply press [Alt] and one of the number keys. 


¢While defining a macro from the keyboard. Press [Ctrl]- [Page 


Up] while defining a macro from the keyboard as the screen dis- 
plays this message: 


1 Pause; 2 Display; 3 Assign; 4 Comment 
Press 3 to select Assign, then enter a variable number. Type the 


value, then press [Enter]. If you later examine the macro you 
made, you will see that WordPerfect automatically added the (AS- 
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SIGN) variable~value~ statement. Note that pressing option 4 in 
the [Ctrl]-[Page Up] menu lets you write a comment (the (;) in- 
struction} in the macro. 


°Copy a value from a block and insert it into a variable. Before ac- 
cessing the Macro Commands key, block the string you want to in- 
clude in the variable, as shown in Figure 4—8. Now press 
[Ctrl]-[Page Up] and press a variable number. The contents of 
the block is automatically transferred to the variable. Most codes 
in a block are ignored and not passed to the variable. The excep- 
tions are Right Indent, Hard Return, Hard Page, and Hard 
Hyphen. Soft Returns are converted to spaces and Soft Pages are 
converted to either Hard Returns or spaces. 


Each variable can contain a maximum of 119 characters when 
entered from the keyboard. 


FIGURE 4-8 COPYING VALUE FROM LARGE BLOCK INTO VARIABLE 


CHAPTER 1 
An icy haze hung over the dank, oil-soaked street, 
dispersing the light of the scattered street lamps into a dim, 
misty halo. Lining the narrow avenue were crouded brick 
S, tattered and worn from age. muddied from the recent 


Once a proud and upwardly mobile neighborhood -- Forty, 


perhaps fifty years ago -- the crumbling butldinygs nou housed 


variety of small, mostly profitless enterpriscCs[iee- Weel Ge ile) 4 
store, an apothacary shop, an office for a unlicensed doctor. 
All were closed for the night: doors bolted shut, iron bars 
locked in place over the windous. 

RA lone figure stood among the brick buildings, a figure 


Variable: _ 
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Assigning Operators With Variables 


With operators, WordPerfect can test the contents of a variable and 
see if it meets the criterion that you have set for it. Most of the 
operators work with numbers only, but some can also be used with 
text. Note that variables store whole numbers (integers) only; when 
entering fractional numbers, WordPerfect assigns them as text. 
The following operators can be used with variables. In all cases, 
you may substitute the values (identified as v1 and v2) as variables, 
as described below. WordPerfect cannot store numbers in variables 


larger than 65,535. Larger numbers are either treated as text or they 
result in an error. 


Operator Function 

lvalue Assigns the binary logical NOT of the value to the 
variable. The logical NOT is the binary equivalent of 
the numerical value inverted—0’s become 1’s and 
vice versa. See the section below for more details. 

-value Assigns the negative of the value to the variable. 
Since WordPerfect variables cannot actually store 
negative numbers, the integer stored is 65,536 minus 
the negative value. For example, negative 15 is stored 
as 65,521. See Chapter Sixteen for more details on 
working with negative integer values. 


vl+v2 Adds values v1 and v2 together and assigns the result 
to a variable. 

vl-v2 Subtracts values v1 and v2 and assigns the result to a 
variable. 

v1*v2 Multiplies values v1 and v2 and assigns the result to 
a variable. 

vi/v2 Divides values v1 and v2 and assigns the integer result 
to a variable. 

v1%v2 Divides values v1 and v2 and assigns the remainder to 
a variable. 

vl&v2 Assigns the logical AND of v1 and v2 to a variable. 

vil v2 Assigns the logical OR of v1 and v2 to a variable. 

vl=v2 If vl and v2 are equal, assigns a -1 (actually 65,535) to 


the variable. If they are not equal (false), assigns a 0. 
vl!=v2 If v1 and v2 are not equal, assigns a -1 (true) to the 
variable. If they are equal (false), assigns a 0. 
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vl>v2 If vlis greater than v2, assigns a -1 (true) to the 
variable. If v1lis less than v2 (false), assigns a 0. 
vi<V2 Ifvlis less than v2, assigns a -1 (true) to the variable. 


If vlis greater than v2 (false), assigns a 0. 


How to Use AND and OR Operators 


Most people panic when they encounter the logical AND and OR 
operators. You may have used similar operators with WordPerfect’s 
sort feature. Well, the variable AND and OR operators are not the 
same, so don’t try to figure out their use based on your experience 
with sorting. 

The variable AND and OR operators work with numbers only. 
When you try to include them in a text string, WordPerfect just 
treats the whole equation as text. Here’s an example: 


(ASSIGN) 1~Now~ 
{ASSIGN)2~Then~ 
(ASSIGN}3~{VAR 1)&(VAR 2)~ 


Run the macro and display the contents of variable 3 (press [AIt]- 
3). The result is Now&Then. But put "9" in variable 1 and "14" in 
variable 2, and you get 8. How? Good question. The answer probab- 
ly isn’t anything you’d use in day-to-day macros, but it can helpful— 
if you plan on being a macro wizard—to understand how ANDing 
and ORing work. 

Consult Figure 4—9 for AND and OR truth tables. Notice what hap- 
pens when you AND two binary digits together. Only when both 
digits are a "1" does the result equal 1. In all other instances the 


FIGURE 4-9 AND AND OR TRUTH TABLES) 
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result is 0. With the logical OR expression, the output is 0 when both 
input digits are "0." In all other instances, the output is 1. 

To visualize how WordPerfect come up with a result of 8 when it 
ANDed the numbers "9" and "14" together, you have to reduce those 
numbers to their binary equivalents. 


Decimal Number Binary Equivalent 
9 1001 
14 1110 


Using the truth table in Figure 4-9 as a guide, manually compute 
what happens when you AND these two numbers together. 


1001 =9 
1110 = 14 
AND 1000 = 8 


Not surprisingly, binary 1000 is equivalent to decimal 8. Using 
the same numbers, perform an OR computation. 


1001 =9 
1110 = 14 
OR 1111 = 15 


For your reference, here are the binary equivalents of zero through 
15. You can count higher by adding an extra 1 on the left. The extra 


digit increases the count by a power of two—31, 63, 127, 257, 511, 
1023, etc. 


Decimal Number Binary Equivalent 
0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 


cr of G BD eM © 


oo on mM 


pad 
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11 1011 
12 1100 
13 1101 
14 1110 
15 1111 


How can this stuff possibly come in handy? The first and foremost 
application of the AND and OR logical operators is to test for a 
specific condition of operation using the (STATE) instruction (see 
the the (STATE) entry under Definition of Macro Statements, 
above). The syntax to use is: (STATE) &value to check. 


olf the value reported by (STATE) is not the same as the value to 
check, ANDing cancels the numbers out and the result is 0. 


olf the value reported by (STATE) is the same as the value to check, 
or contains the value in a larger binary number ANDing returns 
the value to check. 


Some examples to prove it: 


(STATE) = 4 (0100) 
Check Value = 4 (0100) 


0100 (STATE) 
0100 Check Value 
0100=4 


(STATE) = 4 (0100) 
Check Value = 8 (1000) 


0100 (STATE) 
1000 Check Value 
0000 =0 


You can also use ANDing and ORing to perform scientific or 
numerical analysis. If you don’t mind sitting down and doing some 
thinking, you can even have WordPerfect perform complex com- 
parisons of numbers that represent either numerical or textual data. 
Even circuit board analysis is not far off. These advanced applica- 
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tions are not the main thrust of this book, so we'll leave the topic at 
that. 


Working With Text Strings 


When you are comparing non-numeric strings, such as text, enclose 
the values in quotation marks. For example: "valuel"="value2" 
checks to see if the text of valuel is equal to the text of value2. 
Remember that WordPerfect treats all keys on the keyboard, except 
numbers, as text. This includes the [Tab] and [Enter] keys. Word- 


Perfect variables are case sensitive, so the strings must match ex- 
actly. 


Examples: 


Stringi String 2 Result 


hello hello Match 

Hello hello No Match 

HELLO hello No Match 
Multiple Operators 


WordPerfect can handle one operator per expression at a time. You 
can’t add three or more variables together or string them along ina 
complex math statement, such as vl+v2/v3*v4. If you need to per- 


form more complex functions using three or more values, calculate 
the result one step at a time. Here is an example. 


Instruction What It Does 

(ASSIGN}3~(VAR 1)+(VAR 2)~ Adds variables 1 and 2 together 
and assigns the result to 
variable 3. 

(ASSIGN}5~(VAR 3}*(VAR 4}~ Multiplies variable 3 by variable 
4 and assigns the result to 


variable 5. 
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IMPORTANT TOPICS 


°For success at programming WordPerfect macros, learn to think 
like a programmer. Consider writing the macros as routines, and 
learn the meaning behind such concepts as "subroutine" and 
"string." 

o WordPerfect supports up to 20 levels of macro execution. (CASE) 
and (CASE CALL} subroutines use one level of execution each; 
nested macros use two levels of execution. 


°WordPerfect’s macro programming language is available while in 
the macro editing window, and is accessed by pressing [Ctrl]- 
[Page Up]. Select a statement to use by scrolling through the 
menu with the cursor keys, then pressing [Enter] when you get to 
the one you want to use. 

°Control characters can be embedded inside (CHAR), (PROMPT), 
and (TEXT} messages to change the size, appearance, and place- 
ment of text. 

°You can assign values to variables in four ways: directly from the 
keyboard, while editing a macro, while defining a macro from the 
keyboard, and by copying a block directly into a variable. 

eThe AND and OR operators can be used for complex numerical 
comparisons, but are used mostly in WordPerfect macros to test 
for a certain value with the (STATE) instruction. 

eEnclose text strings in quotation marks. The only variable 
operators that can be used with test strings are equal (=) and not 
equal (!=). 

¢WordPerfect can manipulate only two variables or values at a 
time. Break up complex calculations or comparisons into two or 
more separate functions. 


CHAPTER 5 
USING MACROS AND 


MERGES IN MENUS 


Youve come to appreciate WordPerfect’s systems of menus, where 
your command choices are spelled out for you every step of the way. 
Two of WordPerfect’s features, macros and merges, can be used 
together to build a system of custom menus. Your own menus can be 
used as a guide for yourself or for others through the steps of some 
murky task, or as helpful reminders of how to complete a compli- 
cated word processing chore. 
There are four approaches to building custom menus systems: 


¢Generating a full-page menu with macros. 
¢Generating a one-line menu prompt with macros. 
e Generating multiple-line menu prompts with macros. 
¢Generating menus using the merge feature. 
Most menu systems are composed of two parts, an "engine" and 
the actual menu contents. When constructed properly, your menu 


engines can used over and over again to fill in for any application 
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you desire. Once you have the basics down, you'll soon be creating 
menus for every occasion, from preparing mailing labels to sorting 
lists to editing and printing documents. 

This chapter explains how to create and use custom menus. 
Several approaches to building menu systems are included, along 
with basic menu engines you can use for your own applications. This 
chapter serves mainly to present the technique of constructing menu 
systems within WordPerfect. Several actual examples of completed 
menu systems, for a variety of useful applications, appear in Part 
Two of this book and on the Applicatons Disk 


GENERATING A FULL-PAGE MENU WITH 
MACROS 


WordPerfect’s two document screens make it fairly easy to provide 
full-page menus. You write and edit in Doc 1, and the menus are dis- 
played in Doc 2. A macro automatically switches between the two 
and monitors your choices. The basic full-page menu list macro con- 
sists of only a few lines, and you can easily modify it to work with 
any application. This chapter will demonstate how to construct a 
basic "trainer" macro for testing the operation of full-page menus; 
then show you how to convert it to a useful what-do-you-want-to-do- 


next? menu that’s ideally suited for helping new WordPerfect users 
master the program. 


Writing the Basic Engine 


Create the menu engine entirely in the macro editing window. In 
order to access the window, however, you have to redefine an exist- 


ing macro. 
Key Sequence What it Does 
1. [(Ctrl)-[F10] Starts macro definition. 
2. MENUPAGE Names the macro. 
[Enter] 
3. Full page menu Describes the macro. 


engine [Enter] 
4, (CtrlJ-[F10] Finishes the macro definition. 
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5. [Ctr1]-[F10] Starts macro definition again. 
6. MENUPAGE Selects "menupage’ macro to 
[Enter] edit. 
7.2 Opens editing window showing nearly 


blank macro box for "menupage." 


You may now press either 1, to edit the macro description, or 2, to 
edit the macro contents. Press 2 to place the cursor in the editing 
box. 

WordPerfect starts all macros with a {DISPLAY OFF} code. In this 
case, keep it. Use the arrow keys to place the cursor after {DISPLAY 
OFF). Press the [Enter] key to step down a line. Putting instruc- 
tions on separate lines makes writing and "debugging" (fixing) the 
macro easier, and does not actually produce a hard return when the 
macro is executed. 

Type the following macro code, accessing each of the statements 
by pressing [Ctrl]-[Page Up] and choosing the desired one from the 
list (the (DISPLAY OFF) code is shown below to remind you to keep 
it; you don’t need to re-enter it yourself). Other tips: 


oTo type an (Enter) code, press [Ctrl]-V, then press the [Enter] 
key. Do the same for entering the (Home) and (Up) keys (that is, 
press [Ctrl]-V prior to pressing [Up] or [Home]. 

eTo enter a functon, press its corresponding key on the keyboard 
(pres [Shift]-[F38] to enter a (Switch) code, for example. 


o Be sure to type the macro exactly as it is shown. Don’t miss any 
quotation marks or tilde characters. 


Don’t type the step numbers. They are for reference only. 


e Although this macro is included on the Applications Disk, it’s a 
good idea to type it in anyway as a practice for writing your own 
macros. 


The character - means a blank space—simply press the 
[Spacebar]. 


eTo enter a {VAR #) code, press [Ctrl]-V, then [Alt]-# (substitute 
the variable number you want to use for #). If you haven’t already 
done so, now is a good time to make a backup copy of the Applica- 
tions Disk and read through the on-line help included on the disk 
(the help file is a macro; just run it like any other macro). Addi- 
tional information on using the Applications Disk, and accessing 
the macros and other files on it, is included in Appendix C. 
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MENUPAGE.WPM (CHAPS directory on Applications Disk) 


1. {DISPLAY OFF) 
2. (LABEL)loop~ 
(Switch) 
(Home) {Home} (Up) 
(Del to EOP)y 
(Retrieve) MENUL1.TXT{Enter) 
3. (LABEL)start~ 
(DISPLAY ON) 
(CHAR)3~Type a number for your choice.~ 
4, (IE}"(VAR 3}"="1"~(GO)}one~ 
(ELSE) 
MEJ" (VAR 3)"="2"~(GO})two~ 
(ELSE) 
MH" (VAR 3)"="3"~(GO)three~ 
(ELSE) 
MF)" (VAR 3)"="4"~(GO)four~ 
(ELSE) 
MF)" (VAR 3)"="5"~(GO)five~ 
(ELSE) 
MF)" (VAR 3)"="6"~(GO)six~ 
(ELSE) 
(IF)"(VAR 3)"="7"~(GO)seven~ 
(ELSE) 
(END IF) (END IF) (END IF) (END IF) (END IF} 
(END IF) (END IF) 
5. (PROMPT) (^R)Press a number from 1 to 7.(AS)~ 
(BELL) (WAIT) 15~(GO}start~ 
6. (LABEL)one~You pressed 1. (Enter) (GO}repeat~ 
(LABEL)two~You pressed 2.(Enter}(GO)repeat~ 
(LABEL)three~You pressed 3. (Enter) (GO}repeat~ 
(LABEL)four~You pressed 4.(Enter}(GO)repeat~ 
(LABEL)five~You pressed 5. (Enter) (GO}repeat~ 
(LABEL)six~You pressed 6. (Enter) (GO}repeat~ 
(LABEL)seven~You pressed 7. (Enter) (GO)repeat~ 
7. (LABEL) repeat~ (WAIT) 15~ 
(DISPLAY OFF} 
(Switch) 
(GO)loop~ 
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°Step 1 turns the display off so the screen doesn’t show menus or 
text as the macro builds the menu list. 


Step 2 is an automatic loop that restarts the menu after you have 
made a selection. In an actual menu application, you’d probably 
omit the function of the loop, but you’d keep the commands that 
open the menu list document (named MENU1.TXT). The loop is 
provided here to help you test the operation of the macro. 


oStep 3 turns the display back on and presents a {CHAR} prompt 
at the bottom of the screen. The prompt says to type a number to 
choose a menu selection. The MENU1.TXT document has seven 
menu selections, numbered 1 through 7. This portion of the macro 
is identified as a label because it is used as a loop. The (CHAR} 
prompt repeats itself if anything but numbers 1 through 7 are 
typed (see Step 5). 


oStep 4 presents a series of IF. . .ELSE statements for testing the 
character typed on the keyboard. If the character is a 1, the first 
IF. . .ELSE statement is satisfied (TRUE), and the macro jumps 
to the "one" label. If the number doesn’t match the current IF. . 
.ELSE statement, it goes to the next IF... .ELSE statement, then 
the next, until it finds a match. In all cases, the macro jumps to 
the label identified with the IF. . .ELSE statement which proved 
TRUE. 


o Step 5 checks to make sure that a character other than 1 through 
7 has not been pressed. Pressing any other key causes all of the 
IF. . .ELSE statements to be FALSE, and the prompt "Press a 
number from 1 to 7" is displayed. The (^R) and {^S} attributes 
turn reverse video on and off, so that the message won't be missed. 
The macro also sounds the bell as a warning tone, and the (WAIT) 
statement keeps the prompt on the screen for 1.5 seconds. 


¢Step 6 comprises the labels for each of the IF.. .ELSE statements. 
For example, choosing 3 causes the macro to jump to 
(LABEL)three~, and the message "You pressed 3, is shown on the 
screen. Immediately after the message is printed, the macro 
jumps to the label marked "repeat." 


eStep 7 is the "repeat" label. The commands that follow instruct 
WordPerfect to wait 1.5 seconds, turn the display off, switch back 
to Doc 1, then repeat the macro again. This step is provided for 
testing purposes and isn’t used in an actual menu application. 
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When you run the MENUPAGE.WPM macro, the screen tem- 
porarily blanks out, then shows you the menu list, illustrated in 
Figure 5-1. Pressing a number key from 1 through 7 precipitates the 
proper response from the macro. You can be sure that the macro 
works properly when it echoes the correct number you pressed. Be- 
cause this macro loops back onto itself, it will go on forever until you 


cancel out of it. When you are tired of playing with the macro, press 
the [Cancel] key. 


Creating a Mini-menu Application 


Let’s take the basic engine and turn it into something useful. This 
macro offers four options (you can provide more, if you wish): 


e Quit WordPerfect. 
‘Open a document. 
eClear the screen. 


eCheck the spelling of the current document. 


FIGURE 5-1 MENUPAGE MACRO DISPLAY SCREEN 


MENU 


Clear the screen. 


Open a nau document (clear any existing documents). 


Gat help. 

Spell check a document, 
Create an outline. 

Go to DOS. 


Quit WordPerfect, 


Type a number for your choice. 
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To create a new macro called FULLMENU.WPM (don’t type in 
.WPM part) and redefine it so you can edit it once you are in the 
macro editing box. Enter the following programming code: 


FULLMENU.WPM (CHAP5 directory on Applications disk) 


l. 
2. 


O ONO 


(DISPLAY OFF) 

(Switch) 

(Home) (Home) (Up) 

(Del to EOP)y 

(Retrieve MENU2.TXT (Enter) 


. {LABEL)start~ 


(DISPLAY ON) 
(CHAR)3~Type a number for your choice.~ 


. IF)"{(VAR 3)"="1"~(GO}one~ 


(ELSE) 

(IF)" (VAR 3}"="2"~(GO)two~ 

(ELSE) 

(IF)" (VAR 3)"="3"~(GO)three~ 
(ELSE) 

(F)"(VAR 3}"="4"~{GO}four~ 

(ELSE) 

(END IF){END IF){END IF) (END IF) 


. (PROMPT) {“*R)Press a number from 1 to 4.({^S)~ 


(BELL) (WAIT) 15~(GO)}start~ 


. (LABEL})one~(Switch) {(Exit)ny((Exit}ny(QUIT) 

. (LABEL)two~{Switch) (List Files) (Enter) (QUIT) 

. (LABEL) three~ (Switch) (Exit}nn(QUIT)} 

. (LABEL)four~{Switch) (Home) {Home} (Up) (Spell}3 (QUIT) 


eThe menu engine is nearly the same as the previous example, ex- 
cept that there is no loop to restart the macro automatically after 
a choice. In addition, only four options are provided (1 through 4), 
and the routines for the four options reflect the choices displayed 
in the MENU2.TXT document. 

eStep 6 exits WordPerfect, clearing the contents of both Doc 1 and 
Doc 2 (note that the menu list remains after the macro ends; an 
improvement shown below describes how to clear the menu list 
after macro execution). 

¢Step 7 switches back to Doc 1, then calls the List Files menu. The 
macro ends there. 
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*Step 8 switches to Doc 1 and clears it, without leaving Word- 
Perfect. 


¢Step 9 switches to Doc 1, moves to the start of the existing file, 
and begins checking the spelling of the entire document. 


An example of the FULLMENU menu system is shown in Figure 
5-2. Note that options 1 and 8 can result in disaster if they are in- 
advertently chosen. It’s good practice, when providing an automatic 
menu system that deletes a file, exits the program, or otherwise 
might cause great disruption of work, to offer a last-ditch check to 
be sure that the correct option has been chosen. It’s fairly easy to 
provide a fail-safe net within macros. 


Change Step 6 to: 

6. (LABEL)one~(CALL}fail-safe~ (Switch) (Exit)ny 
((Exit)ny(QUIT) 

Change Step 8 to: 

8. (LABEL)three~(CALL)fail-safe~(Switch) 
(Exdt}nn(QUIT) 


FIGURE 5-2 FULL MENU SCREEN EXAMPLE 


WORDPERFECT MENU 


To 

Quit WordPerfect 
Open a document 
Cloar tho ccreen 


Check spelling of current document 


Type a number for your choice. _ 
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Add the "fail-safe" subroutine with this additional step: 
{LABEL)fail-safe~(BELL) (CHAR)2~(4R)Are you sure you want 
to Exit WordPerfect or clear the screen?(Y or N)(AS)~ 
(IF)" (VAR 2)"="Y"~(RETURN) 
(ELSE) (GO)start~ 
(END IF) 


The IF. . .ELSE statement checks to see if you press a capital Y; 
any other character (including N) reprompts for another choice. 
You'll find that if you press a lower-case y, the macro will still 
reprompt for another choice. If you want to capture both lower and 
uppercase of a letter, provide separate IF. . .ELSE instructions for 
them. Write the IF. ..THEN structure as follows: 


(IF)"(VAR 2}"="Y"~(RETURN} 


(ELSE) 
(IF)"(VAR 2)"="y"~(RETURN} 
(ELSE) 

(END IF){END IF) 
(GO)start~ 


In this version, two (ELSE) and (END IF) statements are provided 
(one for each (IF)), and pressing anything but Y or y jumps the macro 
back to the "start" label. 


Deleting the Menu List 


You may create a number of macros that use the Doc 2 screen as a 
temporary scratch pad. If so, you'll probably want to clear the Doc 2 
screen after a menu Selection has been made. That’s easy to do. You 
may also want to suppress the display during the execution of the 
selections. That’s easy to do, too. Add these short segments in the 
(LABEL) lines at the end of the macro: 


6. (LABEL)one~(CALL) fail-safe~ (Switch) (Exit)ny 
(Exit}ny(QUIT) 

7. {LABEL)two~{(CALL)clear~(Switch) (DISPLAY ON) 
{List files) 
{Enter} (QUIT) 

8. (LABEL)three~{(CALL)fail-safe~(CALL)clear~(Switch} 
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(Exit}nn 
(DISPLAY ON) (QUIT) 
9, (LABEL)four~(CALL)clear~(DISPLAY ON) {Switch} 
(Home) (Home) (Up) 
(Spell)3(QUIT) 


And add this subroutine: 
(LABEL)clear~(DISPLAY OFF) 
(Exit)nn 
(RETURN) 


Here is the complete menu macro, with the fail-safe and clear sub- 
routines. 


(DISPLAY OFF) 

(Switch) (Home) (Home) (Up) 

(Del to EOP)y (Retrieve) MENU2.TXT(Enter} 

{LABEL}start~ (DISPLAY ON) 

(CHAR)3~Type a number for your choice.~ 

(IF)"(VAR 3}"="1"~(GO)one~ 

(ELSE) 

(IF}"(VAR 3)"="2"~(GO)two~ 

{ELSE} 

(IF) "(VAR 3)"="3"~(GO)three~ 

(ELSE) 

(IF}"(VAR 3)"="4"~(GO)four~ 

(ELSE) 

(END IF)(END IF) (END IF){END IF) 

(PROMPT) (4R)Press a number from 1 to 4. (^S)~ (BELL) 

(WAIT) 15~(GO)start~ 

(LABEL)one~(CALL}fail-safe~(Switch) (Exit}]ny{Exit)ny (QUIT) 

(LABEL)two~(CALL)clear~(Switch) (DISPLAY ON} (List files) 
(Enter) (QUIT) 

(LABEL}three~(CALL})fail-safe~(CALL}clear~(Switch) (Exit}nn 
{DISPLAY ON} (QUIT) 

{LABEL)four~(CALL}clear~(DISPLAY ON) {Switch} (Home) 
(Home) (Up) 

{Spell} 3(QUIT) 

{LABEL} fail-safe~(BELEL)(CHAR)2~(“R)Are you sure you want to 
Exit WordPerfect or clear the screen?(Y or N){4AS)}~ 

(IF)"(VAR 2)}"="Y"~{(RETURN} 
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(ELSE) 

(IF)"(VAR 2)"="y"~(RETURN) 
(ELSE) 

(END IF)(END IF} 
{(GO)start~ 


(LABEL)clear~(DISPLAY OFF) (Exit})nn(RETURN) 


GENERATING A ONE-LINE MENU PROMPT 
WITH MACROS 


If the number of menu choices is small, or you can’t use the Doc 2 
screen as a scratch pad, you may want to consider developing a one- 
line prompt menu macro. One-line prompt menus are the same kind 
that WordPerfect itself offers, so they are a familiar sight to Word- 
Perfect users. Depending on your requirements, you can write a 
macro that presents just a single set of choices, or a macro that of- 
fers menu levels: pressing an option in one menu drops you down to 
another menu level, and so forth. Both kinds are detailed here. 


Single Level, One-Line Menu Prompt 


One good application of a single level, one-line menu prompt is to 
provide an interactive structure for sorting a table. The sample table 
in Figure 5-3 consists of a series of data. It’s separated into records 
by hard returns, and into fields by tabs. New tab stops were chosen, 
as indicated in Figure 5—4, to accommodate the design of the list. 
The SORTMAC.WPM macro listed below works in such a way that 
the list can be any size, but it must be the only text in the document. 


SORTMAC.WPM (CHAP5 directory on Applications Disk) 
1. (DISPLAY OFF) 
{Home} (Home} (Home) (Up) 
(Down) (Down) 
2. (Block) (Home) {Home} (Down) 
3. (Merge/Sort) 
4. (LABEL)startsort~ 
(CHAR})1~(^R}Sort by: 1 Last Name; 2 Department; 3 
Donation Amount. {4S}~ 
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Last Name 


Department Donation 


Johnson Betty 1588 SS 
Korman B.L. 1081 S18 
Michelson Jennifer 1289 S15 
Gray Bill 1287 $25 
Gray John 1987 S2S 
Torres Emil 1881 $25 
Porter Ted 1881 $25 
Sportsuood Gordon 1289 $35 
Markle Anna 1001 SO 
Tarkington Jane 15808 S75 


Billings Roger 1287 $168 


D: \UPSO\HISC\SORTTEST. TXT Doc 2 Pg 1 Ln 1 Pos 1 


FIGURE 5-3 SAMPLE LIST PRINTOUT 


FIGURE 5-4 TAB SETTINGS FOR LIST 


First Name Department Donation 


Johnson Batty 1500 ss 
Korman B.L. 1801 $160 
Michelson Jennifer 1289 
Gray Bill 1287 
Gray John 1987 
Torres Emil 19001 
Porter Ted 1001 
Sportsuvood Gordon 1289 
Markle Anna 1001 


D: \UPSB\MISC\SORTTEST. TXT Doc Z Pg 1 Ln 1 Pos 10 


bJDonation(CHRt) 

THRtI 

Johnson(TabJBettyl Tab]15@8C TabISSCHRt) 
Kormanl€TabJB.L. (TabJ1801( TabJSIGLHRt) 
MHi{chelson(Tabj Jennifer{TabJ1Z89(TabISiSLHRt) 
GraylTabJBill0TabJ1Z87CTabIJSZS(CHRtI 
GraylTabj] John( TabJ1S87(CTabJSZSCHRtI 
Torres(TabJEsl1CTabl11@81( TabJSZSCHRtIJ 
Porter(Tab) Ted{Tab]1001( TabJSZSCHRtI 


Press Reveal Codes to restore screen 
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(IF}"(VAR 1)"="1"~(GO)name~ 


(ELSE) 

(IF)" (VAR 1}"="2"~(GO)dept~ 
(ELSE) 

(IF)" (VAR 1)"="3"~(GO}amt~ 
(ELSE) 

(END IF) (END IF) (END IF} 


5. (PROMPT)Press 1, 2, or 3 only; or press F1 twice 
to quit.~(BELL) (WAIT) 15~(GO)startsort~ 
6. (LABEL}name~ 
3al(Exit}1 
(DISPLAY ON})(QUIT) 
7. {LABEL})dept~ 
3n3(Exit}1 
(DISPLAY ON}(QUIT} 
8. (LABEL) amt~ 
3n4(Exit}1 
(DISPLAY ON}(QUIT) 


oStep 1 turns the display off and moves the cursor to the beginning 
of the document, then drops down past the first line heading. (Note 
that the list must already be on the screen; the macro doesn’t 
automatically retrieve it from the disk, although you can readily 
add this feature.) 

°Step 2 turns block on and selects the entire list. 

°Step 3 starts the Merge/Sort command. 

°Step 4 provides a prompt to press keys 1, 2, or 3, depending on 
how you want the list sorted. Your choices are by last name, by 


donation amount, or by department. The macro then waits to see 
which key you press, and jumps to the corresponding label. 


eIf you press a key other than 1, 2, or 3, the instructions in Step 5 
will alert you of the error and Step 4 is repeated. 

eStep 6 sorts the list by last name. It indicates the sort keys and 
the type of sort (in this case alphabetic). After sorting, the macro 
ends. 


¢Step 7 sorts the list by department. After sorting, the macro ends. 


¢Step 8 sorts the list by donation amount. After sorting, the macro 
ends. 
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Step 4 comprises the "thinking" portion of the macro. You can 
adapt the macro to just about any application you desire by chang- 
ing the steps before and after it. For example, let’s suppose you store 
your documents in three different subdirectories on your hard disk. 
Instead of remembering and typing the subdirectory name, the fol- 
lowing macro does it for you. Save this macro as ALTS.WPM (for 
gave), and it will automatically prompt you for the correct subdirec- 
tory (the macro is called SAVESUB.WPM on the Applications Disk). 
You press either 1, 2, or 3, then the name of the document. The macro 
makes sure that the file is always stored in the right place. 


SAVESUB.WPM (CHAP5 directory on Applications Disk) 

(LABEL)startsave~ 

(CHAR) 1~(4R)Save in: 1 Business Letters; 2 Forms; 

3 Correspondence (4S)~ 

(TF)"(VAR 1)"="1"~(GO)buslets~ 

(ELSE) 

(IF}"(VAR 1)"="2"~(GO)forms~ 

(ELSE) 

(E)"(VAR 1)"="3"~(GO)corr~ 

(ELSE) 

(END IFJ(END IF){END IF} 

(PROMPT}Press 1, 2, or 3 only; or press F1 twice to quit. ~ 

(BELL) {WAIT} 15~ 

(GO)startsave~ 

{(LABEL}buslets~ 
(TEXT}0~Enter the name of the file to save.~ 
(Save}buslets (VAR 0){Enter) (QUIT) 

{(LABEL)forms~ 
(TEXT}0~Enter the name of the file to save.~ 
(Save}forms\ (VAR 0) {Enter) (QUIT) 

(LABEL) corr~ 
(TEXT)0~Enter the name of the file to save.~ 
{Save)corres\(VAR 0) (Enter) (QUIT) 


This macro is simple and straightforward. When it starts, it asks 
which subdirectory you want to save to. Notice that the choices in 
the menu can be in full English, not the eight-or-less-character cryp- 
tic words often given to subdirectory names (in this example, the ac- 
tual names of the subdirectories are "buslets," "forms," and "corres"). 
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The macro checks your entry, then branches off to the correspond- 
ing label. 


Multiple Level One-Line Menu Prompt 


Designing a multiple level menu simply involves adding more 
choices after the first selection has been made. The macro provided 
here is a test engine, offering two levels with three choices each. 
When the macro ends, it prints out the selections you made. In a real 
application, you'd substitute them for actual WordPerfect com- 
mands. Because it serves only as an example of a multiple-level, one- 
line menu prompt, it is not included on the Applications Disk. 


1. (CHAR}0~Main. Enter 1, 2 or 3.~ 
{IF} (VAR 0)=1~(GO)}sub1~ 
(ELSE) 
(F){(VAR 0}=2~(GO)sub2~ 
(ELSE) 
(IF) (VAR 0)=3~(GO}sub3~ 
(ELSE) 
(END IF}{END IF){END IF) 

2. {LABEL}sub1~ 
(CHAR)}0~Sub 1. Enter 1, 2, or 3.~ 
{IF) (VAR 0)=1~Choice 1, sub 1(QUIT) 
(ELSE) 
{IF} (VAR 0)=2~Choice 2, sub 1(QUIT) 
(ELSE) 
(IF) (VAR 0)=3~Choice 3, sub 1(QUIT) 
(ELSE) 
(END IF) (END IF) (END IF) 

3. (LABEL})sub2~ 
{CHAR)0~Sub 2. Enter 1, 2, or 3.~ 
(IF) (VAR 0}=1~Choice 1, sub 2({QUIT) 
(ELSE) 
(IF) (VAR 0}=2~Choice 2, sub 2(QUIT} 
(ELSE) 
(IF) (VAR 0)=3~Choice 3, sub 2(QUIT) 
(ELSE) 
{END IF (END IH {END IF) 

4, (LABEL})sub3~ 
(CHAR)0~Sub 3. Enter 1, 2, or 3.~ 
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(IF) (VAR 0)=1~Choice 1, sub 3{QUIT} 
(ELSE) 

(IF} (VAR 0)=2~Choice 2, sub 3(QUIT) 
(ELSE) 

(F)(VAR 0}=3~Choice 3, sub 3(QUIT) 
(ELSE) 

(END IF) (END IF) {END IF} 


Step 1 is the main menu. Your are given three choices: 1, 2, or 3. 
For simplicity, error trapping is not provided here, so striking 
another key may yield unexpected results. Refer to the macros 
earlier in this chapter for providing a prompt when another key 
is pressed. Also note that the (VAR 0) statements and numbers 
after the (IF} instructions lack quotation marks. This is accept- 
able if you are looking for only numerals and not letters. You must 
use quotation marks when you are testing for non-numeric charac- 
ters. This includes the (Enter) and (Tab} key codes. 


*Steps 2, 3, and 4 present the same format, but offer different feed- 


back. Your key presses are echoed, showing you that the macro is 
indeed working. 


To design a macro for a specific application, map out the functions 
you want to provide and how the options are nested within one 
another. For example, in a two-tiered menu system that allows you 
to save, retrieve, or look at documents, you have your choice of locat- 


ing the documents in the current directory of your hard disk, or in 
another subdirectory. 


Level 1 Save 
Retrieve 
Look 


Level 2 

Main Directory 
Macros Subdirectory 
Text Subdirectory 


FILER.WPM (CHAP5 directory on Applications Disk) 
1. {CHAR}0~Enter Choice: 1 Save File; 2 Retrieve 
File; 3 Look at File~ 
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{IF} (VAR 0)=1~(GO)save~ 

{ELSE} 

{IF} (VAR 0})=2~(GO)retrieve~ 

(ELSE) 

(IF} (VAR 0)=1~(GO)look~ 

{END IF)(END IF){END IF) 

. (LABEL)save~ 

(TEXT)2~Enter the name of the document.~ 
(CHAR}0~Save file to:1 Current Dir; 2 Macros Dir; 

3 Text Dir~ 

(IF) (VAR 0)=3~(Save) {VAR 2) (Enter) (QUIT) 

(ELSE) 

(IF) (VAR 0)=2~(Save}macros\ (VAR 2) (Enter) (QUIT) 
(ELSE) 

(IF) (VAR 0)=3~(Save)text\ (VAR 2) (Enter) (QUIT) 
(ELSE) 

(END IF) (END IF)(END IF) 

. (LABEL)})retrieve~ 

(CHAR)0~Enter directory: 1 Current; 2 Macros; 3 
Text~ 

(TEXT)2~Enter the name of the file.~ 

(IF) (VAR 0)=1~(Retrieve} (VAR 2) (Enter) (QUIT) 
(ELSE) 

(IF) (VAR 0}=2~(Retrieve)macros\ (VAR 2}{Enter) (QUIT) 
(ELSE) 

(IF) (VAR 0}=3~(Retrieve}text\ (VAR 2) (Enter) (QUIT) 
(ELSE) 

(END IF) (END IF) (END IF) 

. (LABEL)look~ 

(CHAR)0~Enter directory: 1 Current; 2 Macros; 3 Text~ 
(TEXT)2~Enter the name of the file.~ 

(IF) (VAR 0)=1~(List Files) (Enter}n(VAR 2) {Enter} 
6({QUIT) 

(ELSE) 

(IF) (VAR 0)=2~(List Files) (End) (Backspace) (Backspace) 
{(Backspace)macros{Enter}]n{VAR 2) (Enter)6(QUIT) 
(ELSE) 

(IF) (VAR 0)=2~(List Files) (End) (Backspace) (Backspace) 
{(Backspace)text(Enter)n(VAR 2) (Enter)6(QUIT) 
(ELSE) 

(END IF) (END IF) (END IF) 


106 WordPerfect 5.0 Macros and Templates 


*Step 1 provides the first menu, which gives you the choice of 
saving, retrieving, or looking at files. Depending on your choice, 
you are directed to one of three submenus. 


‘Step 2 is the save file submenu. You are given a further choice of 
saving the file on the current directory, in the macros directory, 
or in the text directory. 


¢Step 3 is the retrieve file submenu. You are given a further choice 
of retrieving the file you want from the current directory, from the 
macros directory, or from the text directory. 


Step 4 is the look file submenu. You are given a further choice of 
looking at the file you want contained in the current directory, in 
the macros directory, or in the text directory. 


In all cases, the macro ends after the requested function in one of 
the three submenus has been performed. Note that (VAR 2} is used 


to automatically place the file name you previously entered at the 
required spot. 


GENERATING MULTIPLE-LINE MENU 
PROMPTS WITH MACROS 


You can easily expand the one-line menu prompt to fill all 25 lines 
of the standard IBM PC display. When defining the (TEXT) or 


(CHAR) message for the menu, end each line with an (Enter) charac- 
ter, such as: 


(CHAR)1~What do you want to do next?(Enter) 

1 Quit WordPerfect({Enter} 

2 Start another document{Enter} 

3 Spell check this document{Enter} 

4 Save this document(Enter) 

5 Append another document to the end of this one({Enter) ~ 


An example of a multiple-line menu using (Enter) codes in (TEXT) 
and (CHAR) messages is shown in Figure 5—5. Note that when the 
menu appears, it scrolls the document text up. This has no per- 
manent effect on your work. 
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Write a separate IF... .ELSE statement for each possible entry. If 
you have many menu items, you can shorten the macro considerab- 
ly by using the {CASE} or (CASE CALL) instructions. Enter the vari- 
able after the (CASE) or (CASE CALL) statement, then indicate each 
possible response, followed by the label the macro is to jump to when 
a response matches the case. Remember the double tilde after the 
last label. 


{CASE) (VAR 1)}~ 
1~quit~ 

2~start another~ 
3~spell check~ 
4~save~ 

5~append~~ 

{LABEL} quit~ 

{Exit}nn 

{LABEL)start another~ 


. .and so forth. Use spaces instead of tabs to separate the item 
numbers from the description. You can prompt for any type of 
response, including numbers, letters, or even full text names. Num- 


FIGURE 5-5 MULTI-LINE MENU SAMPLE, WITH FULL SCREEN OF TEXT 


misty halo. Lining the narrow avenue were crowded brick 
buildings, tattered and worn from age, muddied from the recent 
rains. Once a proud and upwardly mobile neighborhood — forty, 


perhaps fifty years ago — the crumbling buildings now housed a 


variety of small, mostly profitless enterprises — a used book 


store, an apothacary shop, an office for a unlicensed doctor. 
All were closed for the night; doors bolted shut, iron bars 
locked in place over the windows. 

A lone figure stood among the brick buildings, a figure 


What do you want to do next? 
Quit VordPerfect 
Start another document 
Spell check this document 
Save this document 
Append another document to the end of this one 
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bers provide the greatest versatility, however, and are easiest to use 
because they have no case (there is no "capital 1," for example). 

Include a (DISPLAY OFF)(DISPLAY ON} pair immediately after 
the multiple line menu. This causes the display to blank out momen- 
tarily, and has the effect of erasing the menu text. Otherwise, some 
of the new text may "float" into the document, as shown in Figure 
5-6. This text is not really a part of the document, and disappears 
after a while, but it can be an annoyance. 


GENERATING MENUS USING THE MERGE 
FEATURE 


A more basic approach to menus is WordPerfect’s merge feature. You 
may prefer to construct your menus using merges if you are in a 
hurry and don’t have time to write and debug an entire menu macro. 
Menu merges use a single primary document that includes the menu 
text, as well as codes for branching off to one of any number of 


macros. Each macro then completes the task, or calls up another 
menu. 


FIGURE 5-6 MULTI-LINE MENU TEXT FLOATING INTO DOCUMENT 


A lone figure stood among the brick buildings, a figure 


accustomed to the dankness of the night and the glare of the 


street lamps. The eyes of the figure slowly scanned up and doun 


the avenue, but the rest of the body was akwardly still, as if 
Jhat do you uant to do next? 


l Quit UordPerfect 
Start another document 
Spel! check this document 
Save this document 
the avenue, but the rest of the body was akwardly still, as if 


the wetness and clinging coldness had paralyzed it. The figure 


was dressed {n a drab, brown overcoat; it was no coincidence that 


the coat was the came color as the aging brick of the surrounding 


buildings. The figure easily merged uith its backdrop, like an 


lizard in the open Texas plains. Or like a python, perched 
D1\UPS@\CHAPL Doc Z Pq 1 Ln 39 Pos 10 
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Figure 5-7 shows one approach to creating a menu list for easily 
accessing previously written macros. 


°The ^O code at the beginning of the document tells WordPerfect 
to display the text that follows. 

o Another ^O code, placed at the end of the document, turns the dis- 
play off. 

°The ^C code tells WordPerfect to pause for keyboard entry. Enter 
your reply and press [Enter]. What you type takes the place of 
the “C code when the merge operation is completed. 

“The ^G codes tell WordPerfect to start a macro as the next step. 
Since the “C code is embedded within the “G codes, your entry 
becomes the name of the macro to run. 


In the example, the menu lists the macros BOX, ENVELOPE, 
LINEHOR, and LINEVER, all of which are included on the Applica- 
tions Disk (future chapters discuss creating and using these macros). 
A description beside the name reminds you what the macro does. The 
^G macros code starts with a macros\ subdirectory (where the 
macros are kept), freeing you from typing it in yourself. If your 


FIGURE 5-7 EXAMPLE MERGE MENU SCREEN 


BOX Dran a box 
ENVELOPE Print an envelope 
LINEHOR Drau a horizontal line 


LINEVER Draw a vertical line 


Enter a macro to uset “Gmacros\*C*G*0 


D: \upS@\MENUTEST Doc 1 Pg 1 Ln 1 Pos 18 
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macros are in the same directory as WordPerfect, or are in another 
directory, edit the ^G prefix as necessary. 

Write the menu using Tab stops to indent. You can experiment 
later with the spacing around the text so that the menu better fills 
the screen. Once the menuis finished, you must remove the Tab stops 
and replace them with spaces, or the merge won’t work. This can be 
done easily by moving the cursor to the top of the document and then 
using the Replace function to exchange the Tabs with five or so 
empty spaces automatically. Use Reveal Codes or Search to check 
for errant [Tab] codes. 

Save the list as MENUTEST, or some other descriptive name, 
clear the screen; then: 


Key Sequence What it Does 

1. (Ctrl)-[F9] Opens Merge/Sort menu. 

2.1 Selects Merge option. 

3. menutest [Enter] Enters MENUTEST the primary 
merge file. 

4, [Enter] Enters a blank as the secondary 
merge file. 


The menu list will then scroll onto the screen, and the prompt at 
the bottom will read: 


Enter a macro to use: macro \ 


Type one of the macro names (upper or lower case) and press 
[Enter]. That macro will then be executed. If you want the macro to 


loop back to the menu, repeat the steps outlined in the key sequence 
above at end end of each macro. 


Helpful Merge Menu Tips 


You can provide easy selection of your menu choices using letters or 
numbers. Each macro associated with the menu starts with the same 
basic name, but ends with a specific letter or number, such as MACI, 
MAC2, MAC3, and so forth. The letter or number you press in the 
menu determines which macro to use. 

Rewrite the “G macro code to include the first letters of the macro; 
the last part you provide when running the menu. Figure 5—8 shows 
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an example where, depending on the letter struck, the merge calls a 
macro named FORMA, FORMB, FORMC, or FORMD. 

If you want to return to the menu after the macro has executed, 
simply recall the merge. Be sure that the menu opens in a blank win- 
dow, or the remnants of a previous document may appear at the top 
of the screen. You can always cancel the menu by pressing [F1] or 
[F9]. You will need to clear the screen of the menu list manually. 

Avoid extra blank lines in the primary document after the last “O 
code. These lines might remain after the macro has been executed. 
If the menu doesn’t scroll up the screen high enough, enter empty 
lines between the list itself and the prompt line. 

If you would like WordPerfect to display the Macro: prompt on a 
separate line when the menu is replayed, place the last “O code 
before the “G code, such as: 

Enter a macro to use: *O*G4CAG 

The screen will display the Macro prompt as shown in Figure 5- 
9. What you type at the prompt replaces the “C code. You can place 
repeating text—for macro names or subdirectories, for example— on 
either side of the “C code. 


FIGURE 5-8 MERGE MENU SCREEN WITH FORM PREFIX 


SCHEDULE A Complete Schedule A. 


SCHEDULE C Completa Schedule C. 


SCHEDULE SE Complete Schedule SE. 


CAL TAX Complete CA Tax Form 


Enter a macro to use! “~Gmacros\FORM*C*G*0O 


Dt \UPSE\TEXT\MENUTEST Doc Z Pg 1 Ln 1 Pos 10 
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Examples: 

eAQAGA:ACAG Finds the named macro on drive A:, such 
as A:ENVELOPE or A:BOXDRAW. 

eAQAGACmrg’G Finds the named macro that ends with 
"mrg," such as "MACMRG" and 
"MENUMRG." 


eAOAGnew*Cmac*G Finds the named macro that starts with 
"new" and ends with "mac," such as 
NEW1MAC, NEW2MAC, and so forth. 


Ifyou can’t display all of the menu choices in one screen, try single- 
spacing or adding an option that calls up a second menu. 


Macro and Merge Compatibility 


Merge menus have more flexibility in version 5.0 of WordPerfect 
than they did in the earlier 4.2 release, because the program can now 
execute macros and merges simultaneously. In the old version, start- 
ing a merge in the middle of a macro would cancel the macro. If you 
tried to use macros and merges together in version 4.2, but were 


FIGURE 5-9 RELOCATED MENU PROMPT 


Draw a box 


Print an envelope 


Drau a horizontal line 


Draw a vertical line 
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frustrated at the limitations, you owe it to yourself to try again. Note, 
however, that WordPerfect will still stop the definition of a new 
macro when you start a merge from the keyboard. The only way to 
program a merge operation in the middle of a macro definition is to 
do it in the macro editing window. 


USING MERGE CODES FOR MANUAL 
TEMPLATE ENTRY 


Another application of the WordPerfect merge feature, using the 
^O and ^C codes you learned about earlier, is to manually enter data 
into a primary merge document. No secondary merge document is 
needed. The “O codes mark the message that appears in the status 
line, and the “C code copies your entry into the merge document. 

Because of the way WordPerfect works, your entries are made in 
acopy of the primary merge document. The original is never touched, 
therefore, it is not prone to accidental erasure or modification. 

Here’s an example of a primary merge document that accepts 
direct keyboard entry. 


“D 

“OEnter first name and last name *0*C 
“OEnter address “*0O%*C 

“OEnter city, state, and ZIP code “*O“*C 


Dear “OEnter salutation (Mr., Mrs., Ms, etc. and last 
name *O“*C: 


We are sure that you will not object to this kind 
reminder that there is a balance of $“*OEnter balance 
due ^O^C on your charge account. 

If you have not mailed your check, do so now. 
Please disregard this notice if payment has already 
been made. Thank you for your payment. 


Sincerely, 
Name 


¢The ^D code prints the current date, as set by DOS. 
eThe ^O codes indicate the message to display in the status line. 
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‘The ^C code after the message stops WordPerfect, and displays 
the template as it is filled in so far (the ^U merge update code is 
not required here). 

Save the template document and clear the screen. Follow these 
steps to use the template in an actual manual-merge operation: 


Key Sequence What it Does 
1, [(Ctrl]J-[F9] Chooses Merge/Sort menu. 
2.1 Selects Merge option. 
3. {template name} Indicates the template to use 
[Enter] as the primary merge document. 
4, [Enter] Skips the Secondary file: prompt without 


entering a file name. 


WordPerfect retrieves the primary merge document and stops at 
the first message. In the case of the example, enter the first and last 
name, but instead of pressing [Enter] at the end of the entry, press 
[F9]. This indicates the end of a field to WordPerfect (the [F9] key 
normally prints a ^R merge code). Repeat the procedure for the rest 
of the messages. 

The merge ends when you have responded to all of the messages. 
You may now print the file or save it on disk for future reference. 
NOTE: It is very important that you do not include any formatting 
codes, including [Tab] codes, between the ^O messages codes. Other- 
wise, WordPerfect will complain when you try to use the document 
in a merge, and will cancel all merge operation. Use Reveal Codes 


to look for stray formatting codes that may still be present in the ^O 
message. 


IMPORTANT TOPICS 


*Full-page menus use a separate menu list document and incor- 
porate a universal macro "engine." 


¢Menu items or macros that might cause disruption to your work 
should include fail-safe features which ask if you really want to 
continue with the operation. A Yes/No prompt, such as the type 


WordPerfect uses for its own prompts, can be created using IF.. 
-ELSE instructions: 
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(IF)"(VAR 2)"="Y"~(GO)yes~ 


(ELSE) 
(IF) "(VAR 2}"="y"~(GO)yes~ 
(ELSE) (GO)no~ 


(END IF)(END IF) 


°One-line menu prompts use the (CHAR) and (TEXT) instructions 
to place a short menu on the status line. You can create menu sys- 
tems that are only one level (select an option and the command is 
immediately carried out), or multiple level. 


°Multiple-line menu prompts are made by adding (Enter} codes in 
the (TEXT) and (CHAR) message strings. Each {Enter} code cor- 
responds to another line on the screen. A (DISPLAY OFF)(DIS- 
PLAY ON} code pair should be added at the end of the menu list 
to clean up the display after a selection has been made. 


oA primary merge document can serve as a Menu Screen and en- 
gine when the document includes merge codes for direct keyboard 
entry. The main merge codes to use are as follows: 


°The ^O code turns display on, and writes the text that follows onto 
the screen. End the display with another “O code. 


°The ^C code tells WordPerfect to pause for keyboard entry and in- 
sert the typed text in place of the “C code. 


°The ^G codes tells WordPerfect to start a macro as the next step. 


eUnlike version 4.2, WordPerfect can now manage merges and 
macros at the same time. However, the program will still cancel 
a macro that you are defining if you start a merge from the 
keyboard. Merge operations must be programmed from within the 
macro editor. 
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CHAPTER 6 
USING TEMPLATES 


WITH MACROS AND 
MERGES 


Dear Mr. Scott: 

Thank you for ordering Desmonds’ Gourmet Chocolate 
Covered Snails. We have processed your order and are 
ready to rush it to you, but as we use United Parcel 
Service two-day delivery, we need a street address 
before we can ship. 


The bulk of work, for most anyone who uses a word processor, i8 
repetitive tasks such as this form letter reply. You may have to 
prepare dozens of letters like this one every day, and do it all be- 
tween your other regular duties. While macros are one approach to 
preparing form letters, your needs may dictate another technique: 
templates. A template is a pattern that you use to prepare regular 
correspondence, invoices, customer reply letters, and other docu- 
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ments where the main body of the text remains the same; only the 
names are changed to direct each document to its rightful owner. 

The design of the template is such that the basic formatting and 
information is already there. You quickly fill in the blanks and print 
out the document. There are a two basic ways you can prepare 
template documents: 


Enter the variable information (the data that changes from docu- 
ment to document) manually. 


¢Enter the variable information with WordPerfect’s merge feature. 
(see the WordPerfect manual for more details on using merge) 


Both methods, outlined in this chapter, have their advantages. 
Entering variable information manually gives you full control over 
the content and placement of each document, but it takes longer and 
is prone to formatting errors. Entering the variable information 
using WordPerfect’s merge function nearly automates the entire 
process and lets you work at full steam. On the downside, you give 
up some flexibility and you have to prepare the template document 
more carefully using merge codes. 


TEMPLATE BASICS 


Keep all template documents readily available on their own floppy 
disks or in a special template subdirectory on your hard disk. Make 
a list of the templates you have created and store the list in a 
template log. If you have many template documents, make sample 
printouts of each one and keep the printouts in a small binder that 
you keep by the computer. 

When you retrieve and fill in a template document, be sure to save 
it under a different name, or you will corrupt the original file. Un- 
less you are used to working with template documents, this is like- 
ly to happen to you at least once or twice in your lifetime. It’s a good 
idea to store extra backups of your templates on a separate disk. 
Then, if you accidentally save a filled-in template, you can retrieve 
an original copy and not lose any time reformatting. 

You can also use the DOS ATTRIB command to prevent a file from 
being erased or replaced. To lock the file, return to DOS, then type 
ATTRIB +R (filename) (replace {filename} with the name of the file 
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you want to lock). This command assigns the read-only attribute to 
the named file. To remove the read-only attribute so that you can 
erase or change the file, type ATTRIB -R (filename). 

You can readily check the current attribute status of all your files 
by typing ATTRIB *.* and pressing [Enter]. DOS will place an R 
beside each file that is currently assigned as read-only, as shown in 
Figure 6—1. Note that the ATTRIB command is found on DOS ver- 
sion 3.0 and later. If you don’t want to leave WordPerfect to write- 
protect a file, use the [Ctrl]-[F1] Shell command to go to DOS 
temporarily. When you are done, type EXIT at the DOS prompt. 


BUILDING FORMAT TEMPLATES 


A format template is a document with little or no text, consisting of 
formatting codes for the proper layout or arrangement of your text. 
Format templates were most popular with the earlier version 4.2 of 
WordPerfect. But with the release of version 5.0, which includes a 


FIGURE6-1 DIR SHOWING SOME LOCKED/UNLOCKED FILES) 


Directory of D:\upS@\text 


LUPLABEL 
3UPLABEL 
ANSUERS 
CONTRACT 
ENVELOPE 
EXPENSES 
GOTTADO 
INU 
INUPRI 
LABELPRI 
LETHEAD 
MENUL 
HENUZ 
MENUTEST 
ORDER 
ORDPRI 
ORDRPLY 
TEXT 
PROVERB 
RESUME1 


MRG 
MRG 
TAT 
MEN 
TMP 
TMP 
TMP 
TXT 
MRG 
MRG 
TMP 
TXT 
TXT 


TMP 
MRG 
TXT 
DOC 
TXT 
TMP 


<DIR> 

<DIR> 
1375 
1374 
2042 


4-86-88 
4-06-88 
1-81-86 
1-92-88 
1-82-89 
1-81-88 
1-02-80 
1-01-80 
1-81-89 
1-01-80 
1-01-89 
1-81-86 
1-01-88 
4-66-88 
1-62-88 
1-81-88 
1-01-80 
4-12-88 
4-12-88 
1-01-89 
1-02-88 
1-82-88 


12: @3p 
12: @3p 
6:32a 
3:59a 
1Z: 61a 
190: 5Zp 
Sı: 85a 
6: 23a 
11:26p 
Z: 58a 
12: 3ðp 
2:J1la 
1:57a 
S: 51a 
1:33Ja 
101: 20a 
180: 30p 
4:685p 
Ziizp 
11:15a 
12: ZZa 
Z1 BSa 
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styles feature, there is far less need to develop format-only docu- 
ments. 

Yet the benefit of styles (covered in Chapter Seven) goes only so 
far. You may still prepare documents that need embedded format- 
ting, making a format template the easiest route. One application of 
format templates is the preparation of tabular numerical data. Sup- 
pose you head a department that must account for its income and 
expenditures at a meeting every two weeks. The basic format of your 
reporting document doesn’t change, just the numbers. 

The format document includes the general layout of the document, 
including the main heading and math definitions, but also has empty 
spaces for the numbers in each column. You fill in the column by 
entering the numbers and pressing the [Tab] key. After all the num- 
bers have been entered, you instruct WordPerfect to calculate the 
result. Assuming you already have the numbers in front of you, 
preparing the document takes less than five minutes, including time 
for printing. 

Magazine writers can create a format header for the first page of 
their articles. The page shown in Figure 6-2 conforms to the ac- 
cepted standard format for nonfiction articles. The name, address, 
and telephone number of the author appears single spaced about 1/3 
down the first page. Opposite is a word count (which you get by using 
the Count option in the Spell menu). The document also contains for- 
matting for a repeating header starting on page 2. The header in- 
cludes the authors name, the page number, and the title of the 
article. The header must be updated for each new article 

The format document includes three blank spaces after the 
telephone number, and a format command to switch to double spac- 
ing. To use the format document, open it, then press [Home]- 
[Home]-[Down] to move the cursor to the last line. You can now 
enter the name of the article and begin. 


BUILDING MANUAL ENTRY TEMPLATES 


A manual entry template consists of formatting and text where you 
enter the variable information yourself directly from the keyboard. 
Apart from using the Search and Replace commands, the process is 
entirely manual. It’s a good method to use if you need only prepare 
a few filled-in copies of the template. 
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Joe Kozlouski About 8##x8 Words 
PO Box 1010 


Los Angeles, CA 38816 
€213)55S5-1212 


Doc 1 Pg 1 Ln 18 Pos 42 


FIGURE 6-2 ARTICLE MANUSCRIPT TEMPLATE, W/ CALLOUTS 


Building the template is easy. Write the document—say an invoice 
for services—and include one of the following for the variable infor- 
mation: 


e Blank spaces. 
e Coded symbols. 


¢Comments. 


Blank Spaces 


A blank can be one or more missing lines in the document or mere- 
ly extra spaces within a paragraph. To enter information into the 
blank, you position the cursor there and start typing. In most instan- 
ces, youll want to keep Typeover off, so that you don’t erase exist- 
ing text. 

The invoices for services is a good example of using blank spaces 
for document fill-in. To prepare the invoice, retrieve it, fill in the 
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name and address of the person or company you are billing, then 
enter the invoice description and amounts (see Figures 6—3 and 6- 
4). If you are billing for more than one item, press [Enter] and place 
the additional item on the following lines. 

When billing for several items, you can calculate the TOTAL your- 
self or use WordPerfect’s math feature. Since the billing amounts 
are all in one column, you don’t need to define a math formula. But 
the procedure is a little more involved than you may think. 


1. Complete the template, then place a [Math On] code at the 
beginning of the text. 

2. Place a + symbol in the column under the billing amounts. This 
tells Wordperfect that you want to add up the numbers above. 


3. Go back and delete the [Math On] code and save the template 
for future use. 

4, To use the template, retrieve it and enter all the pertinent in- 
formation and the billing amounts. 

5. Go back to the top of the document and insert a [Math On] code. 
Next, tell WordPerfect to calculate. 


FIGURE 8-3 BLANK INVOICE 


<Your Nare Here> 

<Your Address Here> 
<Your City, State, ZIP> 
<Your Phone Number> 


June 15, 1988 


Using Templates with Macros and Merges 123 


<Your Name Here> 

<Your Address Here> 
<Your City, State, ZIP> 
<Your Phone Number> 


June 15, 1988 
Rockville Rock Quarry Company 
100 Granite Blvd. 
Rockville, NJ 01111 
INVOICE 


For Professional Services Rendered 


Environmental Impact Study on New Quarry $1,950.00 
Federal Express 33.00 
$1,983.00 


<Your Name Here> 
SSN: ##¢-¢3-8844 


FIGURE 64 FILLED-IN INVOICE 


Why the round-about method? With Math on, WordPerfect as- 
sumes you are entering numbers only, and wants to align everything 
with its default decimal point characters. Pressing n always results 
in the negative N symbol and the letters t and T are treated as math 
operators, not characters in text. And, you cannot place the [Math 
On] code directly in front of the TOTALS columns because Word- 
Perfect treats the code as a math calculation boundary, Numbers 
before the code, even if they are in the same column, are ignored. 

You can supplement the system by writing a macro that places the 
[Math On] code at the beginning of the document and initiates a cal- 
culation. Here is the working body of the macro; provide a name and 
description for the macro as needed. 
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Key Sequence What it Does 

1. [Home]-[Home]-[Up] Brings the cursor to the top of 
the document. 

2. [Alt]-[F7] 1 Turns math on. 

3. [Alt]-[F 7] 2 Calculates. 


Run this macro after you have entered the data into the invoice. 


Codes and Symbols 


The problem with using blanks is that you can forget what goes into 
them and they can easily be missed if you are in a hurry or have for- 
gotten how to use the template. Use a code or a symbol to remind 
you that a piece of information is required. You can either review 
the document yourself to locate the codes and symbols, or use 
WordPerfect’s Search feature to partially automate the process. 


If you are using Search, place an identifying symbol in front of 
each code, such as: 


&&(name) 
@@(amount goes here) 
~{Item, Description, Price) 


It is easier to search for the character(s), not the text used in the 
code. Entering && as the search string will cause WordPerfect to 
stop at every instance of the && symbol. Manually erase the search 
symbol and code and enter the appropriate information. 

If you are filling out a form letter, where variable information 
repeats itself, you may find it helpful to use Replace to insert the 
proper text automatically at each required spot. Let’s say that you 
must repeat the name of a company or person. Enter a code such as 
(name) or (company) in the template. Using the Replace function, 
search for the code you want to find and indicate the text that 
replaces it. WordPerfect automatically erases the old code so you 
don’t have to delete it yourself. 
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Comments 


WordPerfect lets you embed nonprinting comments anywhere in the 
document. You can use this feature to indicate the type of entry that 
should be made in the template. To create a comment, position the 
cursor where you want it to appear, then: 


Key Sequence What it Does 

1. [Ctrl]-[F5] Chooses Text In/Out command. 
2.5 Selects Comment option. 

3.1 Selects Create option. 


A box appears in on the screen. Type the comment and press [E7] 
when you are through. The comment box now appears in your docu- 
ment. You can, if you wish, go back later and edit or delete any com- 
ment. 

If you create acomment in the middle of the line, the comment box 
separates the text, Even though the lines above and below the com- 
ment box look split on the screen, they are still printed as one con- 
tinuous line. Because WordPerfect can search for [Comment] codes, 
you can have the program help you enter variable information. With 
the cursor at the top of the document: 


Key Sequence What it Does 

1. [F2] Chooses Search command. 

2. [Ctr1]-[F5] Selects [Comment] code for search string (you 
needn’t press any other keys). 

3. [F2] Starts the search. 


WordPerfect stops at the next [Comment] code it finds. Enter the 
information requested in the comment box, as shown in Figure 6—5. 


BUILDING MERGE ENTRY TEMPLATES 


Most people associate WordPerfects merge function as a way to 
prepare mailing lists. That’s limited thinking. In fact, merges have 
a greater utility than most people give them credit for. You can 
create quick and easy merge documents that not only tell you exact- 
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<Your Name Hera? 
<Your Address Here? 
‘Your City, State, ZIP> 
<Your Fhone Number? 


Enter invoice name and address. 


For Professional Services Rendered: 


Enter item 1 description. tab, enter amount. 


Enter item Z description, tab, enter amount., 


| Enter {tem 3 description, tab, enter anount. 


Doc 1 Pg 1 Ln 8 Pos 18 


FIGURE 6-5 SAMPLE COMMENTED TEMPLATE 


ly what kind of information is required, but prints the document 
when you are done. 


The typical merge operation consists of two documents, a primary 
file and secondary file. 


*The primary file is the template that includes the basic text of the 


document and also indicates where the variable information is to 
be inserted. 


*The secondary file is the data file; it contains just the variable in- 
formation. 


While the secondary file is useful in preparing regular statements 
to customers and maintaining a mailing list, it isn’t strictly needed 
to create an automated entry template. WordPerfect can merge data 
you type from the keyboard directly into the primary file. An added 
benefit of using merge to prepare forms documents is that the 
primary (original) file is never touched. WordPerfect automatically 
creates copies and places the information you enter into the copy. 
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Auto-merge templates use some of WordPerfect’s more esoteric 
merge codes: ^O, ^C, ^G, and ^P. A full list of merge codes appears 
in Table 6-1. A sample auto-merge document appears in Figure 6— 
6. Instead of the familiar ^F#^ codes usually found in primary merge 
files, this one contains pauses (^C) and prompts (^0). 

Each message prompt, which is displayed at the bottom of the 
screen during merging but not included in the final document or 
printed, is enclosed in a pair of ^O codes. WordPerfect knows to stop 
at each prompt when it gets to the “C codes. This technique of using 
prompts and messages was detailed in Chapter 5, "Macros in Menus 
and Merges." 

To build the template, write it as usual, but enter the merge codes 
from the keyboard. You can choose the codes in either of two ways: 


o Press [Shift]-[F9], then a letter. 
o Press [Ctrl] along with the letter key. 


After you have finished writing the primary file template, save it 
to disk and clear the screen. To run the merge: 


FIGURE 6-6 SAMPLE AUTO-MERGE TEMPLATE DOCUMENT) 


BOX Draw a box 


ENVELOPE Print an envelope 


LINEHOR Draw a horizontal line 


LINEVER Draw a vertical line 


Enter a macro to use: “*Gmacros\“*C*G’O 
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TABLE 6-1 MERGE CODES LIST 


Merge Document 

Code Placement Whatit Does 

AC Primary Temporarily pauses the merge operation 
and waits for keyboard entry. Text 
typed at the keyboard is entered in 
place of the “C code. 

AD Primary Inserts the current date 

AK Secondary Marks the end of a record. Also stops 
the merge when entered from the 
keyboard and stops merge operation 
when placed in the primary document. 

AFnA Primary Field number (n is a number starting 
at 1). 

AG Primary Starts the named macro at the end of 
the merge. 

AN Primary Searches for the next record in the 
secondary file. 

^O Primary Displays the indicated message. 

AP Primary Inserts the name of a new primary 
document to use. 

^Q Primary Stops the merge. 

^R Secondary Marks the end of a field in a secondary 
file. Also used to end keyboard input 
for a ^C code message. 

AS Primary Inserts the name of a new secondary 
document to use. 

AT Primary Sends all of the text merged so far to 
the printer. 

AU Primary Rewrites the screen, showing the text 
merged so far. 

AV Primary Transfers merge codes into the 
document being created. 

Key Sequence What it Does 

1. (Ctrl]-[F9] Selects Merge/Sort menu. 

2.1 


Chooses Merge option. WordPerfect 
displays a Primary File: prompt. 
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3. (template name} Enters name of primary file. 
[Enter] 
4. [Enter] Skips secondary file prompt. 


WordPerfect retrieves the primary file template and copies it. The 
program stops at each prompt and allows you to enter the required 
information. After typing the date, press [F9] to go to the next 
prompt. (Alternatively, you can have WordPerfect automatically in- 
sert the date for you by using the ^D date code.) Note that pressing 
[Enter] doesn’t finish the entry but places you on the next line. Fill- 
ing out the template involves these steps: 


Prompt Finish With 
Enter Today’s Date [F9] 
Enter Name | [F9] 
Enter Street Address [F9] 
Enter City, State, ZIP [F9] 
Enter Name (for salutation) [F9] 
Enter Item [F9] 
Enter Media [F9] 


Enter Credit Voucher Amount [F9] 


After the merged document is finished, you may save it or print it 
out. To do another letter, either clear the screen and repeat the steps 
outlined above, or add a hard page at the bottom of the document 
and start over. 


Automatic Repeat 


If you have many copies of the merged document to send out, you 
may wish to add an automatic repeating feature to the primary file. 
At the bottom of the document, add a hard page (press [Ctrl]- 
{[Enter]), and on the next line: 


APAP 


The two ^Ps indicate that you wish to choose another primary file 
for merging. Normally, you’d put the file you want to use between 
the two ^Ps, but since the name is missing, WordPerfect assumes 
you want to use the same one as before. The end effect is that Word- 
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Perfect automatically repeats the merge operation. After entering 
the data for the first letter, WordPerfect adds a hard page to separate 
the letters and begins again. 

When you get to the last letter, fill it out as usual but don’t press 
[F9] when you get to the final prompt. Instead, quit from the merge 
by pressing (Shift]-[F9], and striking the Q (for quit) key. Word- 
Perfect will end the merge. The double “P codes will remain at the 
end of the last letter, so remove these manually. 


Boilerplate Document Assembly 


WordPerfect 5.0 includes a Master Document feature, which is best 
used for the assembly of documents over 10 or 15 pages. But if the 
document you are piecing together consists of just a few pages, or a 
few paragraphs, you may wish to use the primary merge file as an 
assembly template. This technique is especially useful for assem- 
bling reply letters and contracts from boilerplate text. 

The primary file contains the basic text (if any) that repeats for 
each merged document. The ^C merge prompt asks for the name of 
the text file to use. Enter the name of the file and WordPerfect 
retrieves it and merges its text into the template. Figure 6-7 shows 
a basic primary document that asks for the name of two files. The 
AU codes displays the merge as WordPerfect performs it. 


Merging From a Secondary File 


Direct keyboard entry is the easiest and most straightforward 
method of merging text with a primary document, but the data you 
enter is used one time only. If you need (or want) to keep track of the 
correspondence that you mail out, enter the data first in a secondary 
file and use the secondary file for merging. 

The basic layout of the merge document remains the same when 
using a secondary merge file, but you don’t use “C codes unless you 
specifically want to stop the merge in order to enter something spe- 
cial from the keyboard. As shown in Figure 6-8, place the standard 
AF#A field codes to indicate where the merged data should appear. 

A normally time-consuming and bothersome task is creating the 
secondary file, but the automatic secondary file generator macro 
detailed here can greatly speed up the process. This macro is 
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This is the main body of the primary merge document. 


This is the prompt for the first filer 
“OEnter first file — *P*C*P*0%U 


This is the prompt for the second file: 
“OEnter second file — *P*C*P*0O*U 


D: \UPSG\ TEST Doc 1 Pg 1 Ln 1 Pos 10 


FIGURE 6-7 ASSEMBLY MERGE DOCUMENT SCREEN 


designed for use with the form letter, named LTREMDI.MRG (for 
late reminder #1), illustrated in Figure 6-9. The template asks for 
the name, address, and amount due from customers’ charge ac- 
counts. You can modify the macro to include other types of data. Just 
add or replace the {TEXT) instructions with others of your choice. 
The order with which you place the (TEXT) instructions determines 
the order of the fields in each secondary file record. With the example 


shown— 
Field Contents 
F1 First name 
F2 Last name 
F3 Street address 
F4 City 
F5 State 
F6 ZIP code 


F7 Amount due 
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This is the main body of the primary serge document., 


This is tho prompt for the first file: 
“OEnter first Pile ~ *P*C*P*o“uU 


This is the prompt for the second file: 
“OEnter second file — *P*c*P*OQ*U 


D: UPSON TEST Doc 1 Pg 1 Ln 1 Pos 18 


FIGURE 6-8 SAMPLE F CODES IN PRIMARY DOCUMENT 


—compare these field numbers with their corresponding positions 
in the primary file. 


AUTOMRG.WPM (CHAP6 directory on Applications Disk) 
1. (LABEL) loop~ 
2. (TEXT)}1~Enter the first name. --~(VAR 1)(4R) (Enter) 
(TEXT) 1~Enter the last name. --~(VAR 1}{4R) (Enter) 
(TEXT}1~Enter the street address. --~(VAR 1)(*R}(Enter} 
(TEXT}1~Enter the city. --~(VAR 1)(4R) (Enter) 
(TEXT) 1~Enter the state. --~(VAR 1}(4R}{Enter) 
(TEXT)1~Enter the ZIP code. - -~(VAR 1}(“R)(Enter} 
(TEXT) 1~Enter the amount still due. - -~{VAR 1) (^R) (Enter) 
3. (*E) (AP) 
4. (CHAR)1~Do another record? (y/n). -~ 
(IF}" (VAR 1)"="y'- 
(ELSE) (CHAIN)APPEND (Enter) 
(END IF) 
(GO)loop- 


Using Templates with Macros and Merges 133 


°Step 1 establishes a loop, essentially the entire macro. After you 
finish with one record, the macro asks if you want to do another. 
If you answer yes, you are returned to the loop label. 


°Step 2 comprises the text statements for each field. What you type 
is entered into variable 1. When you press the [Enter] key, the 
contents of variable 1 is printed, and the macro adds a “R and 
[HRt] code to the end of the field. 

°Step 3 finishes the record by adding a ^E merge code and a hard 
page ([HPg]). The hard page is not a functional requirement for 
most merges, but it makes it easier to identify each record in the 
secondary file. 

°Step 4 asks if you want to do another record. If you do, answer y 
(lower case only); if not, press n or any other key. If you want to 
allow for a capital Y, add another IF. . .ELSE instruction to test 
for "Y." 


FIGURE 6-9 FORM LETTER TO USE WITH AUTO SECONDARY MACRO 


“Ea, AFS*% AF6%* 
Dear ^F1^ ^F2^: 


We are sure that you will not object to this kind reminder that 
there is a balance of $^F7^ on your charge account. 


If you have not mailed your check, do so now. Please disregard 


this notice if payment has already been made. Thank you for your 
payment. 


Sincerely, 


<name> 
<title> 
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This macro produces a secondary file in an empty document. You 
need to save the file, then clear the screen (or switch to Doc 2) before 
you can use it in a merge operation. After merging, return to the 
secondary file and append it to your master database. This can be 
done by blocking all of the text, then: 


Key Sequence What it Does 

1. [Ctr1]-[F4]. Selects Move command. 

2.1 Chooses Block option. 

3.4 Chooses Append option. 

4. (filename) Indicates file you want the 

[Enter] block appended (added) to. If the file 

doesn’t exist, WordPerfect will create a 
new one. 


The append operation can easily be made into a macro. The edit- 
ing window for the APPEND.WPM macro is shown in Figure 6-10. 
In the figure, the APPEND.WPM macro names the secondary file 
filename. You can, of course, choose any name you wish. 


FIGURE6-10 APPEND MACRO IN EDITING WINDOW 


Filename 0: \UPSUNTEXTNORDPRI.MRG 


File size: 
^D 


^^ AF2* 

A~Fo*, “Fe* AFT 
Dear ^F1^ “F2*: 
“Fe~ 


Press Exit uhen done (Use Cursor Keys for more text) 
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The entire process of creating the secondary file, saving it for use 
in a merge, performing the merge, then adding the secondary file to 
the master database can be done by one macro. 


AUTOMRGLWPM (CHAP6 directory on Applications Disk) 


l. 
2: 


3. 
4, 


{LABEL)loop~ 

(TEXT) 1~Enter the first name. :-~(VAR 1){4R) {Enter} 
(TEXT) 1~Enter the last name. - -~(VAR 1)}(4R) (Enter) 
(TEXT) 1~Enter the street address. - -~(VAR 1) (^R) {Enter} 
(TEXT) 1~Enter the city. --~(VAR 1}(4R) (Enter) 

(TEXT) 1~Enter the state. --~(VAR 1}(4R) (Enter) 
(TEXT) 1~Enter the ZIP code. - -~(VAR 1) (^R) (Enter) 
(TEXT) 1~Enter the amount still due. - -~(VAR 1} 

(AR) (Enter) 

(^E) (H Pg) 

(CHAR)1~Do another record? (y/n). ~ 

(IF)"(VAR 1)"="y'"~(GO)loop~ 

(ELSE) (CALL)append~(GO)merge~ 

(END IF) 


. (LABEL) merge~ 


(Save) TEMPMRG(Enter) 
(Exit)nn 


. (Merge/Sort}1 


LTREMDI.MRG(Enter) 
TEMPMRG(Enter} 


. (List Files} (Enter)n 


TEMPMRG (Enter)2y0 
(QUIT) 


. (LABEL) append~ (Home)(Home} (Up) 


(Block} {Home}{Home) (Down) 
(Move) l14CUSTFILE(Enter} 
(RETURN) 


¢Steps 1 through 3 are identical to the AUTOMRG.WPM macro 
presented earlier. 


¢Step 4 is nearly identical, except that the (IF} statement is writ- 
ten so that, if true, it branches directly to the {GO)loop~ instruc- 
tion, and if false, it branches directly to the (CALL)append~ 
instruction. On return from the "append" subroutine, the macro 
jumps to the "merge" label. 
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‘Step 5 saves the secondary file as TEMPMRG and clears the 
screen. 


¢Step 6 starts the merge operation and names LTREMDI.MRG as 
the primary file and TEMPMRG as the secondary file. 


eAfter merging, the macro processes Step 7 and deletes the 
TEMPMRG document. 


Step 8 is the "append" subroutine that attaches the newly created 
secondary merge files to a database file called CUSTFILE. 


Personalize this macro by modifying the (TEXT) statements to ask 
for the specific information you need, and by selecting your own 
names for the primary merge file and database file. 


IMPORTANT TOPICS 


¢Keep all template documents readily available on their own flop- 
py disks or in a special template subdirectory on your hard disk. 


¢Make a list of the templates you have created and store the list in 
a template log. 


eIf you have many template documents, make sample printouts of 


each and put them in a small binder that you keep by the com- 
puter. 


¢When you retrieve and fillin a template document, be sure to save 
it under a different name, or you will corrupt the original file. 


Use the DOS ATTRIB command (DOS 3.0 or later) to protect a file 
against accidental erasure or modification. 
To lock the file, type ATTRIB +R (filename}, [Enter]. 
To unlock a file, type ATTRIB -R (filename), [Enter]. 
To check the read-only status of files, type ATTRIB *.* and press 
[Enter]. 
¢Manual entry templates can use one of three systems to identify 


where variable information is to be placed: blank spaces, coded 
symbols, or comments. 


¢The typical merge template consists of two documents, a primary 
file and secondary file. The primary file is the template that in- 
cludes the basic text of the document and also indicates where the 
variable information is to be inserted. The secondary file is the 
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data file; it contains just the variable information. The secondary 
file is not needed when prompt codes are added to the primary 
merge document. 

°To have WordPerfect automatically repeat a keyboard entry 
merge, move the cursor to the bottom of the primary document 
add a hard page (press [Ctrl]-[Enter]), and on the next line type 
APAP. 


CHAPTER 7 
USING STYLES 


Wars in a word? Plenty. Take the word "style." Although the 
word "style" isn’t a particularly colorful word—it doesn’t paint much 
of a picture on its own—its synonyms tell a completely different 
story. 

Style: see also elegance, finesse, polish, refinement, fashion, 
flavor, class, flair, chic, trend, vogue. Although these words don’t all 
mean the same thing, they add up to "style." Writers try to imbue 
their work with at least some of these qualities, some more success- 
fully than others. 

WordPerfect 5.0 has a style feature, but it’s not the kind of style 
you may be thinking of. It has nothing to do with stylistic writing, 
but how those words appear on paper. To WordPerfect, a style is a 
collection of formats that are grouped together in one, convenient 
parcel, Because the formats are tied together, you can easily apply 
them to any or all of your documents. Instead of spending minutes 
changing the formats halfway through a document, you store the for- 
mats in a style and insert them all in just a few keystrokes. Yes, the 
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same basic thing can be done with macros, but styles are more easi- 
ly edited and you can review the contents of a style at any time. 

While styles allow you to change formats easily within a docu- 
ment, they posses another, more profound benefit. Since the formats 
are attached to the styles, you can change the formatting of a docu- 
ment simply by changing the definition of the style. You don’t need 
to search through the document and find every formatting code and 
change them all manually. 

Imagine that you’ve just finished a large report for your boss, and 
in just the nick of time. You’re proud of it because you've spent a 
great deal of time painstakingly setting up formats for the text, 
tables, and illustrations. Even though your boss had seen the rough 
drafts, she doesn’t like the "look" of the finished document. 

Had you not used styles to format the document, your only choice 
would be to kill your boss and try to get rid of the evidence; the al- 
ternative of changing the formats by hand is unthinkable. But with 
styles, just a few changes here and there alters the entire look of the 
document. Instead of stopping at every table to change the tab set- 
tings, for instance, you make a single change in the style and the for- 
mats for all the tables change automatically. 

WordPerfect’s styles have much to offer, with a great deal of its 
potential beyond easy recognition. What’s more, few of the advanced 
applications of these styles are in the WordPerfect manual. In this 
chapter, you'll learn the ins and outs of these styles and how best to 
take advantage of them. You'll learn how to couple them with macros 
for maximum efficiency and how to create a comprehensive "style 
tree’ for building elaborately (yet easily) formatted documents. 


STYLE BASICS 


WordPerfect creates two kinds of styles: paired and open. 


¢Paired styles have a definite on and off point, just like character 
formats (underline, bold, etc.). But, instead of just turning the 
style on and off, you are able to specify two groups of formats. One 
group is active when the style is "on," and the other group takes 
its place when the style is "off." By omitting the "off’ formats, 
WordPerfect reverts to the default document settings. 
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°Open styles have no ending. Their formats stay in effect until you 
select another style or add new formatting. 


Like all WordPerfect formats, only the last format code has an ef- 
fect on the text that follows. If you string a whole list of margin set- 
tings one after the other, only the last one effects the text following 
it. This allows you to have many styles in the document. The formats 
within the style only affect the text that follows it. Likewise, format 
changes you make subsequently, using the regular WordPerfect 
keys, cancel or override the formats in the styles. 

Since styles are a part of the document formatting, they are stored 
with the individual document for which they were created. 
Whenever you retrieve that document, its styles come with it. 
However, you can also share styles among documents and even keep 
a collection of styles on your work disk for easy access. More on this 
later. 

WordPerfect doesn’t come with default or ready-made styles; you 
need to make your own using the Style command. There are two ways 
to define a style: by command and by example. The by-command ap- 
proach is best if you are just learning about styles and when you 
want to create a collection of formats for a new document from 
scratch. The by-example approach is best suited for when you have 
already written some or all of the document and have included for- 
mdtting codes with it. You can define the style by selecting these for- 
mats and copying them to the style definition. 


Defining Styles By Command 


To define a style by command, press [Alt]-[F8] and the style menu 
appears, as shown in Figure 7-1. To create a new style: 


Key Sequence What it Does 


1.3 Chooses Create option. A blank style appears on 
the screen. 

2. 1 (name) Selects Name option and enters 

[Enter] a name for the style. 
3.2 Selects Type option. 
4.1 Chooses Paired style type. 

or 
2 Chooses Open style type. 
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Styles 


Nore 


Type Description 


1 On; 2 Off: 3 Creates: 4 Edit: 5 Delete: 6 Save: 7 Retrieve: 8 Update: 4 


FIGURET-1 STYLE MENU 


6. 3 (description) Describes the style. 
[Enter] 
6.4 Selects Code option; opens Reveal Codes screen 
where you enter desired formats. 


The style codes screen is familiar if you’ve ever used the Reveal 
Codes key. You may include any formatting option that’s normally 
available while in the main document window, with one exception. 
You can’t nest a style definition within another one. If you are creat- 
ing a paired style, do as the on-screen instructions say and place the 
"on" formats before the [Comment] code and the "off' formats, if any, 
after the code. When you are finished defining the style, press [E7] 
to exit. A sample style definition is shown in Figure 7-2 

If you select the paired style type, you have the option of indicat- 
ing the action of the [Enter] key (press 5 to access the Enter key op- 
tion). Normally, the [Enter] key places a [HRt] code in the text, but 
you can also have the [Enter] key serve to turn the style off, or turn 
it off then back on again. 
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| Place Style On Codes above, and Style Off Codes belou, | 


Press Exit when done Doc 1 Pg 1 Ln 1 Pos 10 
Cee J 


(Ln Spacing'zJCTab Set:0°,B.5", 


FIGURE 7-2 SAMPLE STYLE DEFINITION 


Defining Styles By Example 
To define a style by example: 


o Press [Alt]-[F3] to Reveal Codes. 


°Find the codes you want to use for the style and position the cur- 
sor in front of them. 


¢Turn block in (press [Alt]-[T4]). 
¢Move the cursor just beyond the last code you want to use. 
eCall up the Style menu by pressing [AIt]-[F8], then: 


Key Sequence What it Does 


1.8 Chooses Create option. 

2. 1 {name) Selects Name option and enters 
[Enter] a name for the style. 

3.2 Selects Type option. 

4,1 Chooses Paired style type. 
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2 Chooses Open style type. 
5. 8 (description) Describes the style. 
[Enter] 
6.4 Selects Code option. 
7. [Enter] Enters previously copied codes into style 
definition. 


If you are creating a paired style, be sure to place the cursor either 
in front of or behind the [Comment] code, depending on whether you 
want the formatting to be used for the "on" or "off' function of the 
style. Should you want to divide the formatting codes on either side 
of the comment, delete the [Comment] code, then paste in the copied 
formats. As shown in Figure 7-3, add a new [Comment] by position- 


ing the cursor directly over the code that marks the beginning of the 
"off' formats, then: 


Key Sequence What it Does 
1. [Ctrl]-[F5] Chooses Text In/Out command. 


2.5 Selects Comment option. 
3.1 Selects Create option. A comment box appears. 
4. (Text) Type any text into the box (even one or two 
characters is enough). 
5. [E7] Exits the comment box; you are returned to the 
style definition window. 
Applying Styles 


Even though you have created the styles, they do not become a part 


of the document formatting until you turn them on. To turn on a 
style: 


Key Sequence What it Does 

1. [Alt]-[F8] Selects Style command. 

2. {cursor keys) Selects style you want to use. 
3.1 Turns the style on. 


To turn a paired style off, repeat the above procedure but select 
option 2. You can also turn the style off by pressing the [Right] cur- 
sor key so that the cursor moves off the style comment (use Reveal 
Codes to see the cursor move past the [Style Off] code). Remember 
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FIGURE 7-3 WHERE TO PLACE THE CURSOR TO ADD ANEW COMMENT 


that open styles are not turned off; you change formats by applying 
another style or by manually inserting another format code. 


WordPerfect’s Automatic "Off' Codes 


When you don’t provide any "off" codes after the [Comment] when 
defining a paired style, WordPerfect adds whatever codes are neces- 
sary to revert back to the default document settings. 

For example, if the default document setting is single-space, and 
you add a double-space code for the "on" style but nothing for the 
“off style, WordPerfect will automatically enter a [Line Spacing:1) 
code after the [Comment]. An important point to remember: Should 
you change the default format for the document, or alter the format- 
ting before the style definition appears in the document, Word- 
Perfect will automatically update its automatic "off" codes but it may 
not be instantaneous. 
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Style Tricks and Techniques 


There are a number of tricks and shortcuts that can make your time 
with styles even more productive. 


eTo apply a paired style to already written text, block it, and then 
turn the desired style on. The [Style On] code appears before the 
blocked text and the [Style Off] code appears after. 


eTo apply an open style to already written text, place the cursor 
where you want the style to start, then turn the desired style on. 


eYou may edit existing styles by selecting the style you want, then 
choosing option 4 in the Style menu. Once your document is for- 
matted with style, use this feature to change the codes and thus 
the appearance of the already formatted document. 


¢Delete styles you no longer want by selecting the desired style, 
then choosing option 5 in the Style menu. Removing a style has 


the same effect as removing a formatting code in the main docu- 
ment window. 


eYou may search for a given style name by pressing N in the Style 
menu, then typing in the style you want. WordPerfect automati- 
cally selects the style when you have entered enough characters 
to distinguish it from the others in the list. This feature is par- 


ticularly handy when using macros, as discussed later in this 
chapter. 


*Feel free to describe the style as completely as possible in the 
description field of the style definition. You can enter up to 54 
characters for the description. 


Saving, Storing, and Retrieving Styles 


Styles you create and edit are automatically stored with the docu- 
ment when you save it onto disk. You can also save the styles listed 
in the menu in a separate document. Press option 6, and enter a 
filename. Just the style definitions are saved on the disk, and not 
the contents of the document. This option is particularly helpful if 
you share style definitions with other users of WordPerfect or want 
to standardize styles among an office full of WordPerfect users. Note 
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that all of the styles shown in the styles menu are saved in the docu- 
ment, not just the one currently selected. 

WordPerfect does not automatically append an extension to styles 
as it does with macros. You may want to add one of your own so you 
can readily identify it as such. Use a file extension such as .STY or 
.OTL for your saved styles, and store them on a separate disk or sub- 
directory for easy retrieval. 

Styles can be retrieved into a document by pressing option 7, then 
entering the file you want to use. You may choose either a regular 
WordPerfect document that has styles stored with it, or your own 
specially saved style document. If styles already exist in the current 
document, the retrieved styles are added to the list, as depicted in 
Figure 7-4. WordPerfect accepts only one style definition per name, 
so if you try to retrieve a style name that already exists, the program 
tells you that there is a name conflict and asks if you want to replace 
the existing one(s). Answering Yes erases the old styles and plugs 
in the new. Answering No retrieves all those styles that don’t con- 
flict with existing ones. 


Updating Saved Styles 


When you retrieve a style from a regular text document or a style 
document, only a copy of the style definition is placed in the Style 
menu. If you make changes to the style you have imported, those 
changes have no effect on the original, saved definition. Should you 
want to update previously saved styles, repeat the style saving 
routine outlined above. 

WordPerfect will remind you that the file name you have chosen 
already exists. Answer Yes, you do want to replace the existing file. 


Creating and Using the Style Library 


A style library is a master style document that you assign as a 
default for all new WordPerfect documents. The styles in the style 
library automatically pop up when you open the Style menu. Here’s 
how to define a style library: 
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Styles 1 
(existing) 


1 SP 

2 SP 

3 SP 
CHARACT 
NARR MAR 
NEW PAR 
OPENSP 
WIDE MAR 


Definiuon from 
Styles 2 


Composite Styles 


FIGURE 7-4 MERGING STYLES 


Key Sequence 

1. [(Shift]-[F1] 

2.7 

3.6 

4. (style document name} 
[Enter] 


What it Does 

Chooses Setup command. 
Selects Location of Auxiliary Files option. 
Selects Style Library File option. 
Indicates the name of the 

document (regular or style) you want to 
use as the style library. If the file is 
located in another subdirectory or on 
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another disk, include a drive letter 
and path name. 


The style library is not automatically added to the list if styles al- 
ready exist for a document. If you specifically want to add the styles 
from the style library to the current document, press option 8, Up- 
date, in the Style menu. 


ADVANCED STYLES 


Here are some advanced style techniques you'll want to try. 


Copying Style Definitions 


If you are defining several styles that are similar, you can copy and 
paste the formatting codes from one definition to another. That saves 
you some keystrokes and helps prevent errors. Move to the source 
style, turn block on and select those formats you want to use (remem- 
ber to move the cursor past the last format code in order to select it), 
then: 


Key Sequence What it Does 

1. (Ctrl]-[F4] Chooses Move command. 
2.1 Selects Block option. 

3. 2 Selects Copy option. 


Exit the source style and create or edit the destination style. Posi- 
tion the cursor to the spot where you want to place the codes and 
press [Enter]. If you want to copy the codes to more than one style, 
retrieve the codes each time by following these steps: 


Key Sequence What it Does 

1. (Ctrl]-[F4] Chooses Move command. 
2.4 Selects Retrieve option. 
3.1 Selects Block option. 


Here’s a shortcut if you want to copy the entire contents of a style 
to another: Turn the source style on to enter its code into the docu- 
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ment. Select the [Style] or [Style On] code that appears with the 
block function, and copy it as described above. Edit or create the des- 
tination style and paste the copied codes into place. The [Style] or 


[Style On] code is not included; just the formatting that actually 
defines the style. 


Macro Style Execution 


By linking macros with styles, you create a powerful formatting tool 
that can greatly cut down your time in document preparation and 


editing. The most basic macro, shown below, simply calls up the style 
you want to use. 


Key Sequence What it Does 

1. (Ctrl]-[F10] Starts macro definition. 

2. stylecall Names macro (use your own name). 
[Enter] 

3. Basic style on Describes the macro. 
macro [Enter] 

4, [Alt]-[F8] Chooses Style command. 

5. nor9 


Enters name search option. 


6. (style name) Specifies the name of the style you want 


to use. 
7. [Enter] Selects the style. 
8.1 Turns on the style. 


If you have defined a paired style, you may wish to create a 
separate macro to turn off the style. An easier method is to press 


the [Right] key to slide past the [Style Off] code (see Applying 
Styles, above). 


Style Chains 


Macros can also be used to chain to other styles automatically. Let’s 
say you are using a style named STYLE1. In all or almost all cases 
in your document, STYLE! is followed by STYLE2 (this is much 
more common than you may think). When you press the [Enter] key, 
the macro automatically selects STYLE2 for you. The macro is writ- 
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ten, as shown below, to watch out for the moment you press the 
[Enter] key. When you do, it activates the next style. 

In case you don’t want to use the next style (you want to continue 
with the previous one or use another), it’s an easy task to apply the 
proper style manually. About the only requirement is that the styles 
you use should be the open type. For some reason, when using paired 
styles the characters are blanked out when you press the [Enter] 
key. 


STYCHAIN.WPM (CHAP7 directory on Applications Disk) 
1. (DISPLAY OFF) 
(Style)nstyle1{Enter)1 (DISPLAY ON) 
2. (ASSIGN) 2~~ 
(LABEL) loop~ 
(VAR 2) 
(LOOK) 2~ 
(IF)}" (VAR 2)"=(Enter)"~ 
(ELSE) (GO)loop~ 
(END IF) 
3. (DISPLAY OFF) 
(Style})nstyle2(Enter) 1 
(DISPLAY ON) 


o After turning the display off, Step 1 calls up the STYLE1 style. 


o Step 2 waits for you to press the [Enter] key. As long as you don’t 
press the [Enter] key, the macro loops back and prints the charac- 
ters you type. But the moment you hit [Enter], Step 3 is executed. 


eStep 3 calls up the STYLE2 style. 


Note that the loop is constructed so that, with the exception of the 
[Enter] key, characters you press on the keyboard are flowed 
through to the document (this thanks to the (VAR 2) instruction), 
The loop is not repeated when you press the [Enter] key, so an, [HRt] 
code is not normally placed in the text. If you are missing a hard 
return, add an extra (Enter} code after the {END IF) instruction. 

To access the macro quickly and easily, give it an [Alt]-letter 
name. If you run out of [Alt]-letters, construct the macro as a 
keyboard definition and assign it to one of the control keys not nor- 
mally used by WordPerfect. Of course, you’ll probably want to give 
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your styles more descriptive names than STYLE1 and STYLEZ. Just 
be sure to change the macro to reflect the names you have chosen. 


Building a Style Hierarchy 


The formats included in a style take precedence over the formats 
preceding it. These formats remain until the style is turned off or 
until a competing format takes its place. Use this system to build 
style families where the formats of children (or subordinate) styles 
are dependent on the format of their parent (or superior) styles. This 
may be a tough concept to grasp, so take a look at the hierarchy 
diagram in Figure 7-5. There are two superior styles, named 
PARENT! and PARENT2. Their formats are radically different, but 
make up the basic layout of the document. 

The subordinate styles are based on the parent styles. These sub- 
ordinate styles provide only one or two format changes. One subor- 
dinate may add tab stops every inch, for example, and another may 
add a tab stop only at the 2-and 5-inch marks. The subordinate styles 
are heavily dependent on the parent styles. The idea behind style 
hierarchy is that if you need to make a major change, you can do so 
in the parent style and it will "flow through" the subordinate styles 
and have the desired effect on the entire document. The subordinate 
styles do not contain competing formats, so they don’t interfere with 
the action of their superiors. 

If this is difficult to understand, imagine this likely scenario. The 
50-page report you have just finished contains two major formats— 


FIGURE 7-5 CONCEPT OF HIERARCHY STYLES 


Child? ff |  cChild2 Chila1 | 
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an outline format and a modified manuscript format. You construct 
a superior style for each one. But within the report are smaller sec- 
tions that deviate in one way or another from the major formats. 
Within the manuscript are tabular data, graphics, even large head- 
ings. Within the outlines are illustrations and marginal notes. Each 
minor format change is accommodated by a subordinate style. 

Now suppose you need to make a change to the major manuscript 
format: If you change the parent manuscript style, it will affect the 
entire document where that style has been applied. Only those for- 
mats that are specifically changed by the subordinate styles are un- 
affected. What would be the result if you created many unrelated 
styles that reset all the formats each time? You’ve got it! You’d have 
to change the definition of each affected style, and that could mean 
a lot of extra work. 

Explaining the need and use of hierarchical styles is far tougher 
than it is to create them. Simply define the superior and subordinate 
styles, but don’t apply them manually. Construct a set of macros that 
calls both the parent and a subordinate style, such as: 


PARENT1, CHILD3 
or 
PARENT2, CHILD6 


Figure 7-6 shows the codes for a sample macro that calls both 
parent and subordinate styles. Because of the way style hierarchy 
works, all of your styles should be the open type. Note that even if 
you repeat style codes in the document (as you will with the parent 
styles), WordPerfect retains them all. 


Turning Styles Off and On Automatically 


When creating paired styles, you have a choice of defining the func- 
tion of the [Enter] key. Option 5 in the style editing window lets you 
set the function of the [Enter] key while writing and editing text in 
the main document window to one of the following: 


¢Option 1 defines the [Enter] key as the standard hard return. 
Pressing [Enter] while the cursor is between the style off and on 
codes prints an [HRt] code. 
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Hacro: Edit 
File STYLES. UPM 


1 - Description 


{Style}nparent{Enter}1 


(Stylo}nchild{Entor}1 


{DISPLAY OND 


Selection: 2 


FIGURE 7-6 SAMPLE MACRO FOR HIERARCHY STYLES 


¢Option 2 defines the [Enter] key as the "style off’ switch. Press- 
ing [Enter], while the cursor is between the style off and on codes, 
turns the style off. 


¢Option 3 defines the [Enter] key as the "style off/style on" switch. 
Pressing [Enter], while the cursor is between the style off and on 
codes, turns the style off, enters a hard return, then turns the 
style back on. 


IMPORTANT TOPICS 


*Styles have two main purposes: 


1. To enter a complex string of formats. 
2. To quickly change the definition of formats already embedded 
in the text of a document. 


e WordPerfect creates two kinds of styles; paired and open. Paired 
styles have a definite on and off point, just like character formats. 
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Open styles have no ending; their formats stay in effect until you 
select another style or add new formatting. 


°You may define styles by command or by example. 


°To define a new style by command: 


Key Sequence What it Does 
1. [Alt]-[F8] Chooses Styles menu. 
2.3 Selects Create option. 
3. 1 (name) Selects Name option and enter 
[Enter] a name for the style. 
4.2 Selects Type option. 
5. 1 Chooses Paired style type. 
or | 
2 Chooses Open style type. 
6. 3 (description) Describes the style. 
[Enter] 
7.4 Selects Code option. 


Enter the desired codes and press [F7] to exit the style definition 
window. 


°To define a style by example: 


Key Sequence What it Does 
1. [Alt]-[F3] Chooses Reveal Codes command. 
2. (cursor) Moves the cursor to the start of the 
formats you want to include in the style. 
3. [Alt]-[F4] Turns block on. 
4. {cursor} Moves the cursor to the end of the formats 
you want to include in the style. 
5. [Alt]-[F8] Chooses Styles menu. 
6.3 Chooses Create option. 
7. 1 {name) Selects Name option and enters 
[Enter] a name for the style. 
8. 2 Selects Type option. 
9.1 Chooses Paired style type. 
or 
2 Chooses Open style type. 
10. 8 (description) Describes the style. 


[Enter] 
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11. 4 Selects Code option. 
12. [Enter] Enters previously copied codes into 
style definition. 


¢After defining styles (by command or by example), exit the style 
editing window (without applying a style) by pressing [F7] twice. 
eTo apply an already defined style: 


Key Sequence What it Does 

1. [Alt]-[F8] Selects Style command. 

2. (cursor keys) Selects style you want to use. 
3. 1 Turns the style on. 


e Repeat the process to turn a paired style off, but press 2 instead 
of 1. Alternatively, turn a paired style off by pressing the [Right] 
key past the [Style Off] comment. 


eTo apply a paired style to already written text, block it and, then 
turn the desired style on. 


eTo apply an open style to already written text, place the cursor 
where you want the style to start, then turn the desired style on. 


eYou may edit existing styles by selecting the style you want, then 
choosing option 4 in the Style menu. 


*Delete styles you no longer want by selecting the desired style, 
then choosing option 5 in the Style menu. 


You may search for a given style name by pressing N in the Style 
menu, then typing in the style you want. 


eTo save a style in a style document: 


Key Sequence What it Does 
1. [Alt]-[F8] Chooses Style menu. 


2.6 Selects Save option. 
3. (name) Enters name for style. 
[Enter] 


eTo retrieve an already saved style document: 


Key Sequence What it Does 
1. [Alt]-[F8] Chooses Style menu. 
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2.7 Selects Retrieve option. 
3. (name) Enters name for style. 
[Enter] 


°WordPerfect will automatically start all new documents with the 
styles defined in the style library. The style library is a document 
(text or style) that contains the styles you want to use. To define 


a style library: 


Key Sequence What it Does 
1. (Shift]-[F1] Chooses Setup command. 
2.7 Selects Location of Auxiliary Files option. 
3.6 Selects Style Library File option. 
4. {style document name) Indicates the name of the 
[Enter] document to use as the style library. 


°Use cut and paste to copy formatting codes from style to style. 


°Macros can also be used to chain to other styles automatically. 
The macro first defines the initial style to use, then waits for you 
to press the [Enter] key. When you do, the macro calls the second, 
or chained, style. 
°The [Enter] key can be defined as one of three different functions 
in paired style types. 
°Option 1 defines the [Enter] key as the standard hard return. 
°Option 2 defines the [Enter] key as the "style off' switch. 
°Option 3 defines the [Enter] key as the "style off/style on" 
switch. 


CHAPTER 8 
LETTERS AND MEMOS 


C orrespondence forms the backbone of computer word processing. 
Everyone has letters to write, and most people agree that using a 
word processor makes the task a little more palatable. With so much 
emphasis on preparing correspondence, it makes sense to take ad- 
vantage of WordPerfect’s advanced features of macros, styles, and 
merging. With just a few hours of preparation, you can build a sys- 
tem of WordPerfect letter and memo formats that do just about 
everything but the actual writing. 

This chapter presents a collection of business letters and memos, 
and ways to prepare them using more efficiently and professionally 
by using macros, styles, and merge templates. You'll find: 


e Letter correspondence—full—blocked, blocked, and semi-blocked 
letter styles, including a built-in letterhead for business cor- 
respondence; automating letter writing with date, salutation, and 
close macros; as well as how to set up boilerplate text files. 
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¢Memos—quick and easy memos using macros and templates; 
creating a speedy-reply memo. 


LETTERS 


The first thing you probably learned on WordPerfect was how to 
write a letter. Instead of formatting and starting each letter from 
scratch, you can prepare a macro that automatically inserts the 
codes you regularly use in your business correspondence. For ex- 
ample, it is customary to format business letters without right jus- 
tification and without page numbers, and many people prefer to 
center the body of the letter between the top and bottom margins. 
These formats may not be the ones you use for other documents, so 
you'll need to provide some means to quickly change the document 
defaults. 


This macro formats a new document to the following settings. Feel 
free to change the formats as you wish. 


e Right justification off. 
¢Single-spaced. 
¢Widow/orphan on. 
*No page numbering. 


e High-quality print. 


LETFORMT.WPM (CHAPS directory on Applications Disk) 


Key Sequence What it Does 
1. [Ctrl]-[F10] Starts macro definition. 
2. letformt Names macro. 
[Enter] 
3. Standard letter Describes macro. 
format 
4, (Shift]-[F8] Selects Format menu. 
5. 1 Chooses Line option menu. 
6.3N Turns justification off. 
7. 1 [Enter] Selects single-spacing. 
8.9 Y Turns widow/orphan protection on. 


9. [Enter] 2 Exits Line option menu and selects Page 


10.79 

11. [Enter] [Enter] 
12. [Shift]-[F7] 

13. T 4 [Enter] 


14. [Ctrl]-[F10] 
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option menu. 

Turns page numbering off. 

Leaves Format menu. 

Selects Print menu. 

Selects high-quality print option, exits 
Print menu. 

Ends macro definition. 


Run this macro whenever you want to start a new letter using 
these formats. If one or more of the formats are already defaults, it 


won’t make any difference. 


Storing the Formats As a Style 


If you don’t care to have all those format codes at the beginning of 
your letter documents, define a style (call it LETFORMT) following 
the same steps outlined above, but without defining a macro. Next, 
save the style using the Save option in Style menu as “LET- 
FORMT.STY." When you want to use the style in a new document: 


Key Sequence 
1. [Alt]-[F8] 
2. 7 letformat.sty 


3.1 


What it Does 

Chooses Style menu. 

Retrieves the LETFORMT:STY style 
document (containing only the 
"LETFORMAT" style). 

Turns on the style and returns you to 
the editing window. 


You can reduce the number of keystrokes required to call the style 


by defining a macro. 


LETTER.WPM (CHAP8 directory on Applications Disk) 


Key Sequence What it Does 
1. [Ctrl]-[F10] Starts macro definition. 
2. letter Names macro. 
[Enter] 
3. Standard letter format Describes macro. 
4, [Alt]-[F8] Chooses Style menu. 
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5. 7 letformt.sty Retrieves the 

[Enter] LETFORMT.STY 1 file, turns 
on the LETFORMT style, and 
returns you to the editing 
window. 


If you have stored more than one style in the LETFORMT.STY 
file, all of the styles are retrieved and placed in the Style menu. You 
can indicate the one you want with the name search option in the 
Style menu. Press N (or 9), type the name of the style you want to 
use, press [Enter], and strike 1 to turn on the style. 


Blocked Letter Styles 


Three of the most popular letter styles are blocked, semi-blocked, 
and full-blocked. Examples of each are shown in Figures 8-1, 8-2, 
and 8-3. The full-blocked letter style is a snap to format because all 
of the lines start at the left margin, including the date and com- 
plimentary close. Paragraphs are not indented, but they do have an 
extra space between each one. The LETFORMAT style described in 
the last two sections is perfectly suited for preparing full-blocked let- 
ters. 

The blocked (also called modified blocked) letter style places the 
date and complimentary close at the approximate center of the page, 
between the left and right margins. This format is less formal, and 
if you've set up the tab stops ahead of time, is really no trouble to 


write. If you use the blocked letter style, add the following tab code 
to the LETFORMAT style described earlier: 


Key Sequence What it Does 

1. [Shift]-[F8] Selects Format menu. 

2.18 Chooses Line and Tab options. 

3. [Ctrl]-End] Deletes all of the tab stops to the right 
of the 1" margin mark. 

4.3.5 [Enter] Places a left aligned tab at 3.5". 


5. EN [Enter] [Enter] Sets tab; exits Format menu. 


Pressing the [Tab] key expresses you to the center of the page, 
where you can write the date and close. 
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January 15, 1989 


Mr. Carmen G. Avildson 
80 Brookhurst Ave. 
Elgin, IL 60120 


Dear Mr. Avildson: 


Thank you for ordering our best~selling book, Successful Indoor 
Gardening On a Budget. We could find no payment for the book, 
however, and our company policy requires pre-payment on all 
orders. We are enclosing a flyer that fully describes the book 
and its money-saving contents. 


We’re sure that you will enjoy the many full color pictures and 
step-by-step gardening instructions, plus the handy fold-out 
climate chart that details the best climates and regions for 
specific types of indoor plants and shrubs. The $12.95 cover 
price for Successful Indoor Gardening On a Budget is small in 
comparison to the money you’ll save on buying and growing your 
favorite garden vegetables. 


Again, thank you for your order. We appreciate your business and 
wish you success for indoor gardening on a budget. 


Sincerely, 


John Drake, Publisher 
enc. 


FIGURE8-1 FULL-BLOCKED LETTER EXAMPLE 
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January 15, 1989 


Mr. Carmen G. Avildson 
80 Brookhurst Ave. 
Elgin, IL 60120 


Dear Mr. Avildson: 


Thank you for ordering our best-selling book, Successful Indoor 
Gardening On a Budget. We could find no payment for the book, 
however, and our company policy requires pre-payment on all 
orders. We are enclosing a flyer that fully describes the book 


and its money-saving contents. 
We're sure that you will enjoy: 


. The many full color pictures and step-by-step gardening 
instructions. 


. The handy fold-out climate chart that details the best 


climates and regions for specific types of indoor plants and 
shrubs. 


The $12.95 cover price for Successful Indoor Gardening On a 


Budget is small in comparison to the money you'll save on buying 
and growing your favorite garden vegetables. 


Again, thank you for your order. We appreciate your business and 
wish you success for indoor gardening on a budget. 


Sincerely, 


John Drake, Publisher 
enc. 


FIGURE 8-2 BLOCKED LETTER EXAMPLE 
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January 15, 1989 


Mr. Carmen G. Avildson 
80 Brookhurst Ave. 
Elgin, IL 60120 


Dear Mr. Avildson: 


Thank you for ordering our best-selling book, 
Successful Indoor Gardening On a Budget. We could find no 
payment for the book, however, and our company policy requires 
pre-payment on all orders. We are enclosing a flyer that fully 
describes the book and its money-saving contents. 


We’ re sure that you will enjoy the many full color 
pictures and step-by-step gardening instructions, plus the handy 
fold-out climate chart that details the best climates and regions 
for specific types of indoor plants and shrubs. 


The $12.95 cover price for Successful Indoor Gardening 
On a Budget is small in comparison to the money you’1ll save on 
buying and growing your favorite garden vegetables. 

Again, thank you for your order. We appreciate your 
business and wish you success for indoor gardening on a budget. 


Sincerely, 


John Drake, Publisher 
enc. 
JD/gsr 


FIGURE 8-3 SEMI-BLOCKED LETTER EXAMPLE 
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The semi-blocked letter style is similar to the blocked letter style, 
except that the paragraphs are indented five to 12 spaces. This re- 
quires an additional tab stop for the paragraph indention. 


Key Sequence What it Does 

1. (Shift]-[F8] Selects Format menu. 

2.18 Chooses Line and Tab options. 

3. (Ctrl]-End] Deletes all of the tab stops to the right of 
the 1" margin mark. 

4, 1.75 [Enter] Places a left aligned tab at 1.75 inches. 

5. 3.5 [Enter] Places a left aligned tab at 3.5" inches. 


6. [F7] [Enter] [Enter] Sets tab; exits Format menu. 


Pressing the [Tab] key once expresses you to the paragraph in- 
dent stop. Pressing the [Tab] key once more expresses you to the 
center of the page for writing the date and close. 


Automatic First-line Indention 


Although pressing the [Tab] key for indenting each new paragraph 
of a semi-blocked letter isn’t a big nuisance, you can create a style 
that does it for you, thus saving you a few keystrokes and maintain- 
ing uniformity in all your letters. Use the style with an Alt-letter 
macro so that you can call it up when you need it. 


Key Sequence What it Does 
1, [Alt]-[F8] Chooses Style menu. 
2.38 Selects Create option. 
3. Semi-block Names style. 
[Enter] 
4.3 First line indent for Describes style. 
semi-blocked letter 
[Enter] 
9.53 Choose Off/On format for Enter 
key. 
6.4 Enters style definition window. 


Define the style, as shown in Figure 8-4, with a single [Tab] code 
before the comment and a [HRt] code after the comment. Press [E7] 
twice to exit. Select the Semi-block style if it isn’t already, then select 
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Place Style On Codes above, and Style Off Codes belou. | 


Press Exit when done Doc 1 Pg 1 Ln Z Pos 18 
CCo eer a a Sang 2 


[Tabl Commeant)CHRE) — 


FIGURE 8-4 AUTO INDENTION STYLE DEFINITION 


option 1 to turn it on. Notice that the first line of every paragraph is 
indented at the first tab stop (0.75 inches, using the indention for- 
mat specified above). Pressing the [Enter] key ends the style defini- 
tion, then starts it up again. 

To use the Semi-blocked style in regular work, save it in the LET- 
FORMT.STY file along with the LETFORMAT style. As an added 
time saver, the macro below retrieves the LETFORMT.STY file, 
selects the Semi-block style, and turns it on. Use the macro after you 
have entered the date, name, and salutation. 


SEMIBLOK.WPM (CHAPS directory on Applications Disk) 


Key Sequence What it Does 
1. [Ctrl]-[F10] Starts macro definition. 
2. semiblok Names macro. 
[Enter] 
3. Auto-start macro for Describes macro. 


semi-block style 
[Enter] 
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4, [Alt]-[F8] Chooses Style menu. 

5. 7 letformt.sty Retrieves the 
LETFORMT.STY file. 

6. N Semi-block [Enter] Searches for and selects 
Semi-block style. 

7.1 Turns on the Open letter style; 
returns you to the editing 
window. 


When you want to stop using the style, turn it off from within the 
Style menu or use the [Right] key to skip over the style code. 


Adding an Integrated Letterhead 


If you don’t have preprinted letterhead, or don’t want to pass it 
through your printer, you can have Wordperfect add the letterhead 
to the first page of every letter. Your letterhead can be text only, a 
combination of text and graphics, or all graphics. The letterhead is 
stored in the header of the document, which is turned on for the first 
page only. 

Although you can build the letterhead for each document using 
just a macro, a more efficient approach is to use a ready-made 
template along with a supporting macro. The macro retrieves the 
letterhead template, immediately asks you to give it a new name (so 
that you don’t accidentally erase the original), and drops the cursor 
for the first line of text. 

First, construct the letterhead as shown in Figure 8—5. The letter- 
head itself is placed in the A header. The example uses centered and 
bold text surrounded by a box frame (made with Line Draw), but you 
can create your own letterhead using any technique you desire. If 
you have a laser printer that supports downloadable fonts, or has 
fonts builtin, select a large, easy-to-read font for the company name 
and address. You may also wish to use a logo or other graphic with 
the letterhead. WordPerfect’s graphics feature lets you pull graphics 
files previously saved on the disk and insert them into frames within 
the document. Graphics look particularly good when produced on a 
laser printer. 

Exit the header and decrease the top margin to 0.5". This pushes 
the letterhead further up the page, allowing you more space in the 
body of the document. You may also include other formatting codes 
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FIGURE 8-5 LETTERHEAD IN HEADER 


that you regularly use for your letters, including left and right mar- 
gin settings, tab settings, and so forth. Add one or two empty lines 
so that the cursor stops a little below the header. Save the document 
as LETHEAD.TMP; you can use another descriptive name of your 
choice, but be sure to indicate the new name in the macro. 

The macro retrieves the document, then immediately resaves it. 
A (TEXT) prompt asks for a new name. Type it in and press [Enter]. 
The macro then moves the cursor to the end of the document, in 
preparation for writing. 


LETHEAD.WPM (CHAPS directory on Applications Disk) 


1. (Retrieve, LETHEAD.TMP(Enter) 

2. {TEXT)}0~Save file as. --(include drive and subdirectory, if 
necessary): ~ 

3. (Save) (VAR 0}({Enter) 

4. (Home}{Home}({Down) 


eStep 1 retrieves the file LETHAD.TMP. 
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*Step 2 asks you to give a new name to the file. Your text entry is 
stored in variable 0. 


¢Step 3 saves the file with the name you provided. 
¢Step 4 moves the cursor to the end of the document. 


Write the body of the letter as usual. When you are finished, save 
it again (press [F10], then answer Y to the prompt that appears), 
and you are ready print the letter. 


Automatically Inserting the Date and 
Complimentary Close 


Even if your business letters are all different, some things never 
change; you still need to include the date and a complimentary close. 
These can be readily inserted using macros. If your computer main- 
tains the current date, or you regularly re-enter the date whenever 
you turn on the machine, you can use WordPerfect’s date stamp fea- 
ture to provide the date for you automatically. Save the macro as an 
[Alt]-letter combination ([AIt]-D is a good choice), so that you can 
access it easily. Two versions of the macro are presented: 


‘The first version prints the date using the default date format 
(which you may have changed using the Date Format option in 
the Initial Settings menu). 


The second version sets the format to Month, Day, Year, then 
prints the date. You may rewrite the macro to print the date in 
any format you wish. For example, service personnel (and 
diehards who can’t learn civilian ways), as well as Europeans, like 
the Day, Month, Year date format. 


Version 1: ALTD.WPM 


Key Sequence What it Does 

1. (Ctrlj-[F10] Defines a new macro. 

2. [Alt]-D Names macro. 

3. Date stamp Describes macro. 
[Enter] 


4, (Shift]-(F5] 1 Inserts date at current cursor position. 
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5. (CtrlJ-[F10] Ends macro definition. 


Version 2: ALTD.WPM 


Key Sequence What it Does 
1. (CtrlJ-[F10] Defines a new macro. 
2. [Alt]-D Names macro. 
3. Date stamp, with Describes macro 
format 
[Enter] 
4. [Shift]-[F5] 8 Selects Date Format option in 
Date/Outline menu. 
5.31,4 [E7] Selects format, exits. 
6.1 Inserts date at current cursor position. 
7. [Ctri]-[F10] nds macro definition. 


The complimentary close for your letters may be simple, such 


ASi 


Sincerely, 


John Doe 
.. .or elaborate: 


Yours very truly, 


ANDERSON, PIKE AND ROOSEVELT 


Milton Thomas Roosevelt, Esq. 


MTR/jxrg 
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In either case, you can commit the closing of the letter to a macro. 
Define the macro in the usual way, name it [Alt]-C, and enter the 
close exactly as you want it to appear at the end of the letter. If you 
are not using a full-blocked letter style, add tabs to express the lines 


to the center of the page. If you make a mistake, start over or edit 
the macro later. 


Setting Up Boilerplate Files 


How many times do you find yourself typing the same thing letter 
after letter? Repeated text can be inserted into documents using 
macros. While most people think of assigning only large chunks of 
text as boilerplate macros, you should not overlook the short phrases 
and sentences you retype countless times each day, such as: 


eI am looking forward to hearing from you... 
e As you may know... 


eIn reference to your letter dated... 


To be practical, boilerplate macros should be given [AIt]-letter 
names. Keep a list of the macro definitions handy so that you may 
refer to them often. Some macros will be used more often than others, 
and you will commit these to memory faster and won’t have to use 
the crib sheet to remind you which buttons to push. If you run out 
of [Alt]-letter combinations, assign some keys as [Ctrl]-letter 
macros, using WordPerfect’s key remapping feature. 


Merged Letters 


Another approach to preparing many letters in one sitting is to use 
WordPerfect’s merge feature. Prepare the primary merge document, 
complete with formatting and on-screen prompts (using the “C and 
^O merge codes). Start the merge by specifying the name of the 
primary merge; press [Enter] when WordPerfect asks for the name 
of the secondary file. Fill in the letter according to the prompts. 
When you have completed a prompt, press [F9] to go to the next one. 
See Chapter 7, "Using Templates With Macros,” for more informa- 
tion on using merge documents for text fill-in 
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MEMOS 


Imagine a world without interoffice memos. Although a lot of people 
would look forward to such a paradise, memos are a fact of business. 
Macros can make your memo writing more pleasant, or at least speed 
up the process to minimize the agony. 


Basic Memo 


You can write a basic macro that types out "INTEROFFICE MEMO" 
at the top, then pauses while you enter the date, the subject of the 
memo, your name, and to whom you are writing. A sample memo, in 
construction, is shown in Figure 8-6. 


MEMO.WPM (CHAPS directory on Applications Disk) 
1. (Center) (Bold)INTEROFFICE MEMO (Bold) {Enter} (Enter) 
2. DATE:- -(PAUSE} (Enter) (Enter) 
SUBJECT: -(PAUSE) (Enter) (Enter) 
FROM: -(PAUSE}(Enter}{Enter) 


FIGURE 86 SAMPLE BASIC MEMO 


Inter Office Meno 
DATE: May 12, 1989 
SUBJECT: Overtime hours 
FROM: E. U. Baker 


TO: ALL 


Effective immediately, all overtime hours must be included 
in the weekly time cards, and not used as “comp time” for accrued 
sick pay or extra vacation days. To reiterate this company’s 


policy (in accordance with state law), overtime applies to” 
- Work exceeding eight hours a day: 
OR 


. Work exceeding 48 hours a week. 


This is based on our current five day work-ueek schedule. 


Doc 1 Pg 1 Ln 23 Pos 66 
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TO:: (PAUSE) (Enter) (Enter) 


¢Step 1 centers and boldfaces INTEROFFICE MEMO at the top of 
the page. 


Step 2 prints DATE:, SUBJECT:, FROM:, and TO:, pausing to 
allow you to enter the information. The macro continues when you 
press the [Enter] key after each entry. If you are the sole user of 
the memo macro, you can delete the (PAUSE) after FROM: and 
put your name there. The double (Enter} codes after each 
(PAUSE) provide two spaces between lines 


Reply Memo 


You can have WordPerfect automatically format the memo with 
reply boxes for use by the recipient. Add the following lines to 
MEMO.WPM, and create the reply box memo (named [AIt]-Z) as 


shown. If you already have an [Alt]-Z, you can pick any other name 
you like. 


REPMEMO.WPM (CHAPS directory on Applications Disk) 
1. (Esc)60-(Enter) 
(PROMPT}Press Enter and write the memo here. 
Press Alt-Z when done with the memo. - -~ 
2. (LABEL) loop~ 


(LOOK) 1~ 

(F)"(VAR 1)"="(Enter}"'~ 
(ELSE) (GO)loop~ 

(END IF} 


*Step 1 adds 60 dashes, then displays the prompt "Press Enter and 
write the memo here. Press Alt-Z when done with the memo." The 
prompt remains until you press the [Enter] key. 


*Step 2 is a loop that constantly waits for you to press the [Enter] 
key. When you hit [Enter], the macro ends. The prompt message, 
or a portion of it, may disappear as you write the text, this is nor- 
mal and is the result of WordPerfect rewriting the screen display. 


ALTZ-WPM (CHAPS directory on Applications Disk) 
1. (DISPLAY OFF} 
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Inter Office Meno 
DATE: May 12, 1989 
SUBJECT: Order in Time for Christmas 
FROM: Bill Anderson, Continental Imports 
TO: Roger D. Perts 
Bill, I°’d like to put in a rush order for 7 (seven) cases of 
“Amazing X-Ray Glasses,” at our previously arranged discount of 
SS percent off list. I need them in time to process orders for 


the Christmas season. Can you do it? Please let me know as soon 
as possible. 


O Please respond g Please call O FYI 


Doc 1 Pg 1 Ln 22 Pos 18 


FIGURE 8-7 FINISHED REPLY MEMO 


2. (Home){Home} (Left) 
(Screen)21(Esc)74({Right)0(Enter) 

5 ee ee (Screen)21(Right) (Right) (Down) (Left} (Left) (Up) 6 
(Right) (Right) (Right) (Right)0 
Please respond: - 

4, (Screen)21(Right) (Right) (Down) (Left) (Left) (Up)6 
(Right) (Right) (Right) (Right)0 
Please call: - 

5. (Screen)}21(Right) (Right) (Down) (Left) (Left) (Up)6 
(Right) (Right) (Right) (Right}0 

FYI (Down) (Enter) 


eStep 1 turns the display off. 


*Step 2 draws a line 74 characters across (assuming one inch stand- 
ard margins for the left and right). 


eSteps 3, 4, and 5 draw the check boxes and print the text "Please 
respond," "Please call," and "FYI." Note the five empty spaces 
before the first box in Step 3. | 


A completed reply memo, with boxes added, is shown in Fig- 
ure 8-7.) 


CHAPTER 9 
BOILERPLATE 


BUSINESS 
CORRESPONDENCE 


Í, the previous chapter, you learned how to use macros, styles, and 
templates to create one-at-a-time letters and memos. These docu- 
ments consist of a few standard elements such as letterhead, basic 
format, and complimentary close. But the body of the document 
varies from document to document. One memo may be about how 
yov’d like a different brand of coffee in the office, and another may 
specify an important new company-wide policy. 

Boilerplate business correspondence differs from routine business 
letters and memos in that they share common text. A billing notice 
sent to one customer is the same, with few exceptions, as the billing 
notice sent to another customer. Boilerplate text consist of words, 
phrases, even entire paragraphs shared between many documents. 
You can use boilerplate text to prepare notices, reply letters, re- 
quests for services, bids, and catalogs, even contracts. 


177 


178 WordPerfect 5.0 Macros and Templates 


In this chapter, you will find an assortment of macros, styles, and 
templates for creating your own: 


eCustomer notices. 

e Requests or orders for services, products, or bids. 
«Merged reply letters. 

¢Macro-driven reply letters. 


¢Contracts. 


USING THE MERGE TEMPLATE DOCUMENTS 


The template documents contained in this chapter are designed ex- 
pressly for WordPerfect’s merge feature, and function as primary 
merge documents. You need to prepare a secondary merge document 
that provides the variable data that is automatically placed in the 
primary template document. 

The secondary merge document contains the data divided into 
records and fields. Each field is separated by a ^R merge code; each 
record is separated by a ^E merge code. You can enter these codes 
by pressing [Ctrl]-R or [Ctrl]-E, or by choosing one of the merge 
codes from the merge code list (press [Shift]-[F'9] to access the list). 


To make a secondary document, enter each field on a separate line. 
Be sure to add the ^R field code after each entry or WordPerfect 
won't understand how you have organized the data. When the field 
for a complete record is complete, add a ^E merge code and, option- 
ally, a hard page (press [Ctrl]-[Enter]). Here’s a sample secondary 
merge document with three records, with four fields each. Note that 
the fields are in the same order for each record. This is a necessity: 


Bill^R 

Tombley^R 

123 Addison Ave.^R 
San Diego^R 

^E 


Apy dammi — am a m a Oa a ED Om OUD Ga One oe a ee D D a oe ee ee ee d ee ee ee 


— ome rep Oe ee ee ee ee wn ee ee oe 


Jane^R 
Alexander^R 
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PO Box 9764R 
Oceanside’R 
^E 


Burton^R 
Racliff^R 

7654 Elm St.^R 
Del Mar^R 

^E 


Save the secondary document and clear the screen. Then follow 
these steps: 


Key Sequence What it Does 

1. [Ctrl]-[F9] Selects Merge/Sort menu. 

2.1 Chooses Merge option. 

3. (primary file} Enters primary file name (such 
[Enter] as LTREMD1.MRG). 

4. {secondary file} Enters secondary file name. 
[Enter] 7 


WordPerfect will assemble the merged documents on the screen, 
unless you have used additional codes to send the merged output 
directly to the printer. 

An easy way to create secondary date files is to use a macro that 
automates the process. AUTOMRG.WPM and AUTOMRGI1.WPM, 
found in Chapter 6, show how a macro can be used to prompt for the 
data fields for a secondary merge document. Once the data is 
entered, the macro compiles it into a form that WordPerfect expects 
of secondary merge files. You can easily modify these macros to ask 
for any type of data. 

While you may generate secondary date files for use with the 
templates that follow, you may find it easier—if you have only a few 
letters to mail out each day—to enter the information directly from 
the keyboard. The merge templates in this chapter are not specifi- 
cally designed for this task, so you will need to modify them for direct 
keyboard entry. Chapter 5, "Macros in Menus and Merges," shows 
you how to merge information entered from the keyboard, and how 
to include on-screen messages so that WordPerfect prompts for the 
specific information to enter. 
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CUSTOMER NOTICES 


Do you have some customers or clients who are behind in their ac- 
counts payable? Do you need to make an important announcement 
to your clients, and want each announcement to look like a personal 
letter? Customer notices are easily prepared using WordPerfect’s 
merge feature. You write the basic text of the letter and indicate 
where the variable information is to be placed. In a second file, you 
include the pertinent information for each customer— name, ad- 
dress, account number, balance due, or special note. 

Here is an assortment of business letter templates that are 
designed for merging with WordPerfect. In each letter, fields provide 
spaces to place name, address, salutation, and variable information 
pertinent to the subject of the letter. For example, in addition to the 
standard name and address, the letter BDCHECK indicates the 
number, amount, and date of a check that has been returned unpaid 


from the bank. Like the name and address, these three special items 
are merge fields. 


You will need to modify these. 


All of the business letters included on the Applications Disk use 
this field entry convention: 


Field 


Purpose 
F1 First name 
F2 Last name 
F3 Street address 
F4 City 
F5 State 
F6 ZIP code 
F7 Misc. item 1 
F8 Misc. item 2 
F9 Misc. item 3 
F10 Misc. item 4 
F11 Misc. item 5 


If you already have a data file with customer names and addres- 
ses, you may have entered the information in a different order or 
manner. You'll need to modify the business letters before you can 
use them with your data file. All of the template documents are in- 
cluded in the Applications Disk under the name specified. 
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LTREMDLMRG (CHAP9 directory on Applications Disk) 
The late reminder letter, version one, is a gentle prompt that the ac- 


count is over due. Use this letter for aged receivables between 30 and 
60 days old. 


Field Purpose 

AD Automatic date 
F1 First name 

F2 Last name 

F3 Street address 
F4 City 

F5 State 

F6 ZIP code 

F7 Balance due 


LTREMD2.MRG (CHAP9 directory on Applications Disk) 


This is version two of the late reminder merge letter. Its language 
is a bit stronger, and hints that the customer's credit privileges will 
be suspended soon if payment is not received. Use LTREMD2.MRG 
for aged receivables between 45 and 90 days old. 


Field Purpose 

^D Automatic date 
F1 First name 

F2 Last name 

F3 Street address 
F4 City 

F5 State 

F6 ZIP code 

F7 Balance due 


LTREMD3.MRG (CHAP9 directory on Applications Disk) 


For the real deadbeats, version three of the late reminder letter 
suspends credit privileges and promises legal action if payment is 
not received within the specified period of time. Use this letter for 
aged receivables over 90 days old. 
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“D 


“F4%, AFS“ AF G6* 


Dear ^F1^ “*F2*: 


Ve are sure that you will not object to this kind reminder that 
there is a balance of $*F7* on your charge account. 


If you have not mailed your check, do so now. Please disregard 


this notice if payment has already been made. Thank you for your 
payment. i 


Sincerely, 


<name> 
<title> 


FIGURE9-1 LTREMD1.MRG LETTER 
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^D 


^nFE3^ 
^F4^, ^F5^ “AF 6% 
Dear ^F1^ ^F2°^: 


We still have not received payment of $^F7^ remaining on your 
charge account. In order to avoid a suspension of your credit 
privileges, won’t you please remit full payment today? 


If there are any questions or problems with your account balanca, 
please contact us immediately. Disregard this notice if your 
have already mailed your payment. 


Sincerely, 


<name> 
<title> 


FIGURE 9-2 LTREMD2.MRG LETTER 
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Field Purpose 

AD Automatic date 
F1 First name 

F3 Street address 
F4 City 

F5 State 

F6 ZIP code 

F7 Balance due 


RESTATELMRG (CHAP9 directory on Applications Disk) 


The late reminder letters shown above lump an entire account into 
one amount past due. RESTATE1.MRG lets you itemize up to four 
separate invoices. The merged letter does not provide for adding up 
the amounts due; you'll need to calculate that yourself. 


RESTATE2.MRG (CHAP9 directory on Applications Disk) 


RESTATE2.MRG uses the same construction as the previous letter, 
but uses stronger language. 


Field Purpose 

AD Automatic date 

F1 First name 

F2 Last name 

F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Invoice 1 (see format below) 
F8? Invoice 2 (optional) 
F9? Invoice 3 (optional) 
F10? Invoice 4 (optional) 
F11 Total due 


BDCHECK.MRG (CHAP9 directory on Applications Disk) 


The BDCHECK.MRG template serves as a kind announcement that 
a customer's check has been returned unpaid by the bank. The let- 
ter provides spaces for check number, amount, and date written, as 
well as amount due (check amount plus bank and service charges). 
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“D 


AP AS, ARS“ ArPG6%* 
Dear ^F1^ ^F2^: 


Your account with us is past due. As of today’s date, we have 
not yet received payement for the following invoiced items: 


APTA 
“F8?% 
SFI 
^F10?^ 
TOTAL DUE: ^F11^ 
Won’t you please take the time to remit payment today? Thank you 


for your prompt attention to this matter. 


Sincerely, 


<name> 
<title> 


FIGURE 9-3 RESTATE1.MRG LETTER 
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“D 


AFL* *F2° 

AF3* 

^F4^, APSA af^ 
Dear ^F1^ ^F2^; 


We have contacted you several times and have discussed 


arrangements for the payment of your delinquent account. The 
following items are still overdue. We have indicated the 
original invoice number, the date of sale, and the amount owed. 
“FB?% 
AF9?% 
“F10?% 
TOTAL DUE: ep oe Oo Nias 


We pride ourselves in quality products and efficient, courteous 
service; in return, we ask for prompt payment. We must insist 
that you remit payment immediately. Please use the postage paid 
envelope that is enclosed for your convience. 


Sincerely, 


<nane> 
<title> 


cc: Legal Department 


FIGURE 94 RESTATE2.MRG LETTER 
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Field Purpose 

AD Automatic date 

F1 First name 

F2 Last name 

F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Check number 

F8 Check face amount 
F9 Check date written 
F10 Amount due (with service charges) 


MOVING.MRG (CHAP9 directory on Applications Disk) 


Use MOVING.MRG to announce to friends, relatives, business as- 
sociates, and clients that you are changing location. 


Field Purpose 

AD Automatic date 
F1 First name 

F2 Last name 

F3 Street address 
F4 City 

F5 State 

F6 ZIP code 


NEWACCT.MRG (CHAP9 directory on Applications Disk) 


This template welcomes a customer as a new account to your firm. 
Slots are provided to indicate terms, credit limit, and payment re- 
quirements. 


Field Purpose 

AD Automatic date 
F1 First name 

F2 Last name 

F3 Street address 
F4 City 

F5 State 


F6 ZIP code 
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^D 


Ar4*, APS” AF6* 
Dear ^F1^ *F2*: 


You check, number “F7* for $*F8*, written to us on *F9%, has been 
returned unpaid by your bank. 


We all make mistakes when it comes to bank accounts and balancing 
checkbooks, and we are sure that this returned item is the result 
of a simple oversight. 

In order to remedy tbis situation quickly and efficiently, we ask 
that you immediately mail a certified check or money order for 
$°F10*, which reflects the amount of your check, plus bank fees 
that have been charged against ovr account. 

Your prompt remittance will enable us to close our books on this 
matter and return your original check to you. 


Sincerely, 


<name> 
<title> 


cc; Collections 


FIGURE 9-5 BDCHECK-MRG LETTER 
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“D 


AF 4*, AFS* AFEG* 

Dear ^F1^ “*F2%: 

We are moving! The last <## months or years> have been a period 
of great change for us, and we have finally outgrown our present 
location. As of <effective date>, our new address and phone 
number will be: 


<new address> 
<new phone number> 


Please make a note of it in your files <or payment coupon books, 
etc.> 


Sincerely, 


<name> 
<title> 


FIGURE 9-6 MOVING.MRG LETTER 
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“D 


“F\* 4£F 2% 
AR3* 
aa) eae “~F5* “F6%* 


Dear ^F1^ “F2%: 


We are happy to accept your application for an open credit 
account with <name of firm>. Your credit privileges have already 
begun, and you may take advantage of your new buying power 
immediately. Based on the information you provided us, we have 
set an initial credit limit of $^F8^, payable “*F7%. If you 


require a higher limit, feel free to contact our Credit 
Departnent. 


*F97^ 
Sincerely, 


<name> 
<title> 


FIGURE 9-7 NEWACCT.MRG LETTER 
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F7 Terms (net 30, etc.) 
F8 Credit limit amount 
F9? Special terms and conditions (optional) 


REQUESTS OR ORDERS FOR SERVICES, 
PRODUCTS, QUOTES, OR BIDS 


The request templates use the same format as the customer notices 
detailed in the last section. A collection of sample requests are 
provided here; make changes to them as necessary. If you regularly 
send out requests for single-item quotes and bids, you'll want to con- 
struct a template that includes a merge field for the product or ser- 
vice you are interested in, as well as the specific closing date for 
replies. 


CHRGEQ.MRG (CHAP9 directory on Applications Disk) 
This letter is for businesses seeking credit with suppliers, mer- 


chants, and others. The letter provides merge fields for personaliz- 
ing the request. 


Field Purpose 

^D Automatic date 

F1 First name 

F2 Last name 

F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Item purchased (can be general) 

F8 Years or months conducting business 


QUOTE1.MRG (CHAP9 directory on Application Disk) 


Send out this template when you wish to receive quotes for services 
or products. You may ask for a quote on only one item, but you are 
able to specify the maximum price and delivery time you are willing 
to consider. When requesting quotes for products, you may want to 
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“D 


“F2* 
apga, *F5S* “P64 


Dear ^F1^: 


We have been purchasing ^F7^ from you for “*F8* on a cash-on- 


delivery basis. Now we would like the convenience of an open 
charge account with your firm. 


Please let us know what information references you require to 


establish an account. We would also appreciate a summary of your 
credit terms. 


Sincerely, 


<name> 
<title> 


FIGURE 8-8 CHRGREQ.MRG LETTER 
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^D 


PELAA 


Dear ^F1^: 


We are currently developing a program of vendor sources. We 
would appreciate a quote from you on ^F7^. 


Please return your quote in the postage paid envelopo that is 
enclosed. Our closing time for quotes is <date>. Thank you for 
your prompt attention. 


Sincerely, 


<name> 
<title> 


FIGURE 9-9 QUOTE1.MRG 
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include an additional field that indicates the approximate, quantity 
per month, your company will be buying. 


Field Purpose 

AD Automatic date 

F1 First name 

F2 Last name or company 
F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Quote for item 


QUOTE2.MRG (CHAP9 directory on Applications Disk) 


This request for quote template provides up to four spaces for ser- 
vices or products you wish to receive. 


Field Purpose 

AD Automatic date 

F1 First name 

F2 Last name or company 

F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Quote for item 1 

F8? Quote for item 2 (optional) 
F9? Quote for item 3 (optional) 
F10? Quote for item 4 (optional) 


LETORDER.MRG (CHAP9 directory on Applications Disk) 


The LETORDER.MRG template is designed for placing orders for 
products when you don’t have an official order form. You may indi- 
cate up to four items (more if you add additional fields in your copy 


of the template). 
Field Purpose 
AD Automatic date 


Fl Company Name 
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^D 


^F2? ^ 
AF4%, AF5* AFGE* 
Dear ^F1^: 


We are currently developing a program of vendor sources. We 
would appreciate a quote from you on the following item(s): 


“F8?* 
ig as as 


“F107* 


Please return your quote in the postage paid envelope that is 
enclosed. Our closing time for quotes is <date>. Thank you for 
your prompt attention. 


Sincerely, 


<name> 
<title> 


FIGURE 9-10 QUOTE2.MRG 
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^D 


4F1% 

PERES 

SF” 

^F4^, AFS5* AFG6* 

Dear “F1%; 

Please send the following items as soon as possible. ^F7^ 
mEo?* 


“F102% 


Thank you for your prompt attention. 


Sincerely, 


<name> 
<title> 


FIGURE 8-11 LETORDER.MRG LETTER 
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F2 Suite, department, or attention (optional) 
F3 Street address 
F4 City 
F5 State 
F6 ZIP code 
F7 Item 1 
F8? Item 2 (optional) 
F9? Item 3 (optional) 
F10? Item 4 (optional) 
MERGE REPLY LETTERS 


Mail order companies must produce a bevy of reply letters to indi- 
cate the progress of shipping, the availability of items, the restate- 
ment of company policies and procedures, and much more. Even if 
you are not in the mail order business, you may find yourself tap- 
ping out numerous letters of reply to each customer inquiry, ques- 
tion, or problem. That can be counterproductive, taking up the time 
you could otherwise use in a more profitable activity. The layout of 
these reply letters is identical to the customer notices and requests 
presented above. 


DELAY.MRG (CHAP9 directory on Applications Disk) 


Federal trade regulations require that products ordered through the 
mail be shipped within 30 days. If the order can’t be filled within 
that time period, the mail order company is required to send a let- 
ter, with a stamped, self-addressed envelope, that offers the cus- 
tomer the chance either to cancel the order or wait the specified 
period of time until the order can be filled. The DELAY.MRG letter 
provides merge fields for indicating the item ordered (you may use 
a generic phrase if the order consists of many items), the expected 
date of shipment, and a cutoff date for a customer response. 


Field Purpose 

^D Automatic date 
F1 First name 

F2 Last name 


F3 Street address 
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“D 


^aF1^ ^AF2^ 

AF3% 

APES, AES“ “F6* 
Dear ^F1^ ^F2°^: 


Thank you for your order for our ^F7^. 


We have been blessed with orders for ^F7^ and demand has far 


outstripped supply. We are temporarily sold out but we are 
awaiting a new shipment from the factory. We expect to fill 
current orders on or before ^F8^. You may, if you wish, cancel 


your order and receive a full refund. We have provided a postage 
paid postcard for your reply. If we do not hear from you by 
“F9*, we will assume you still wish to receive the ^F7^, and we 
will place you in our active shipping roster. 


We are sorry for any inconveniences this delay may cause you. 


Again, thank you for your order and we look forward to serving 
you. 


Sincerely, 


<nane> 
<title> 


FIGURE 9-12 DELAY.MRG LETTER 
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F4 = City 

F5 State 

F6 ZIP code 

F7 Item ordered 

F8 Latest expected delivery date 
F9 Cutoff date for customer 


SOLDOUT.MRG (CHAPƏ9 directory on Applications Disk) 


Send this letter on those sad occasions when an ordered item is sold 
out. Instead of mailing just a credit voucher or a refund, this letter 
explains the situation, offers a credit, and suggests that the cus- 
tomer use the credit to order something else from the enclosed 
catalog (you can change this to a flyer or brochure, if necessary). 
Most states require that you include a stamped, self-addressed en- 
velope with this kind of correspondence. 


Field Purpose 

^D Automatic date 

F1 First name 

F2 Last name 

F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Item sold out 

F8 Advertising media (may not be applicable 
to your situation), 

F9 Credit amount (less shipping/handling 
charges for any items that were shipped). 

F10 Catalog, sales brochure, flyer, ete. 


RESREPLY.MRG (CHAP9 directory on Applications Disk) 


Responding to resumés and employment applications submitted by 
mail is a common business courtesy. The RESREPLY.MRG template 
provides a fast and painless way to respond to those candidates who 
don’t meet your employment criteria. You’ve probably received a let- 
ter like this one at some time in your professional career (most of us 
have), so the contents are fairly familiar. 
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“D 


AP1* “F2° 
AF3“ 
AF4*, ARS“ AFE* 


Dear ^F1^ ^F2^: 


Thank you for your order for our ^F7^ that was advertised in 
SEB; 


Unfortunately, that item is sold out and we do not anticipate 
receiving additional shipments from the factory. We have 
enclosed a credit voucer for the amount of ^F9^, along with a 
copy of our latest ^F10^. Feel free to browse through the page 


of our savings-packed “F10* and place your order by phone or 
mail. 


You may, if you wish, mail in the credit voucher for a full and 


prompt refund. A postage paid envelope is enclosed for your 
convenience. 


Again, thank you for your order and we look forward to serving 


you again. 


Sincerely, 


<nane> 
<title> 


FIGURE 9-13 SOLDOUT.MRG LETTER 
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^D 


ADAM ARSA AREA 

Dear ^F1^ ^F2^: 

Thank you for allowing us to review your resume for the position 
of ^F7^. 


We have carefully reviewed your qualifications and find we do not 
have an appropriate position for you at this time. Wo will keop 
your resume on file for six months, and should a position that 
matches your qualifications develops, we will contact you. 


We appreciate your interested in employment at <name of company>, 


and wish you continued success. 


Sincerely, 


<name> 
<title> 


FIGURE 9-14 RESREPLY.MRG LETTER 
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Field Purpose 

AD Automatic date 

F1 First name 

F2 Last name 

F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Position applied for 


DLYPAY.MRG (CHAP9 directory on Applications Disk) 


Oops! Despite your best efforts, you (or your company) are having 
trouble meeting your financial obligations. This letter politely asks 
your creditors to hold the dogs at bay until you can gather up the 
cash. The letter is particularly helpful for small businesses in the 
first few years of life, nonprofit organizations, and computer book 


writers. 
Field Purpose 
^D Automatic date 
F1 First name 
F2 Last name 
F3 Street address 
F4 City 
F5 State 
F6 ZIP code 
E7 Amount outstanding 
F8 Date expected for accounts receivable 


check 
NOCOD.MRG (CHAP9 directory on Applications Disk) 


Your mail order company doesn’t accept COD orders, and this letter 
reminds customers of your policy. The template lets you specify the 
item and advertising medium (useful for direct response ads), and 
the total amount, with shipping, handling, and applicable sales tax. 


Field Purpose 

^D Automatic date 
F1 First name 

F2 


Last name 
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“D 


AF 4%, AF5* SEG 
Dear ^F1^ “*F2°: 


We have an uncomfortable request: we are asking for an extension 
of time on our accounts payable to you for the amount of $^F7^. 


We have been counting on a check from one of our accounts to 
cover this bill. However, we have been informed that this 
payment will not reach us until “*F8%, 

Therefore, we ask your dinulgence and that you grant us an 


extension of time, until “F8%*, to pay our obligation to you. We 
are sorry about any inconvenience this may bring you. 


Sincerely, 


<name> 
<title> 


FIGURE 9-15 DLYPAY.MRG LETTER 
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^D 


sis 8 OY aay 

AF22° 

AF3° 

AF4*, AFS* AREA 


Dear ^F1^: 


Thank you for your order for our ^F7^ that was advertised in ^F8^ 
on “F9*%, 


Unfortunately, our company is not set up for C.O.D. shipments. 
Acceptable methods of payment are <check and/or charge>. . The 
total price of “F7*, including shipping and handling, is ^F9^. 


Meanwhile, we are holding your order aside with instructions to 


rush shipment as soon as we receive payement. Again, thank you 
for your order. 


Sincerely, 


<name> 
<title> 


FIGURE 9-16 NOCOD.MRG LETTER 
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F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Item ordered 

F8 Advertising media 
F9 Total amount due. 


DONATE.MRG (CHAP9 directory on Applications Disk) 


Yov’d like to help out all the needy charities in the world, but simp- 
ly don’t have the resources to do it. DONATE.MRG gracefully 
declines a request from your business for a donation. The letter in- 
cludes a statement that your business contributes to United Way; 
retain this part if it applies to you. 


Field Purpose 

^D Automatic date 

F1 First name 

F2 Last name 

F3 Street address 

F4 City 

F5 State 

F6 ZIP code 

F7 Charity 

F8 Method of solicitation: letter, phone call, 
visit, etc. 


MACRO-DRIVEN REPLY LETTERS 


Let’s say that you are in the mail order business, and you sell a series 
of books on gardening. You are tired of writing, from scratch, the 
various reply letters that you send to customers. Some say, "thank 
you, the book is enclosed"; others say that "payment is insufficient," 
"payment was not enclosed," or "here is the information you re- 
quested." What you need is a system of document assembly macros 
which you can execute depending on the circumstances. 
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“D 


SF12* ^E27?^ 

a OF fs 

AF3° 

AFAA, SESA AEG“ 


Dear ^F1^ ^F2°^: 


Thank you for your recent ^F8^ requesteing a donation to ^F7^. 
As I am sure you are aware, it is impossible to support all the 
worthwhile causes in our troubled world. Our company has a 
policy of making an annual contribution to the United Way Fund, 
which in turn supports many nationnal and local organizations. 


In view of our policy, we are unable to make a contribution to 
OFT. It is an admirable cause and I wish you luck in your 
endeavors. 


Sincerely, 


<nane> 
<title> 


FIGURE 8-17 DONATE.MRG LETTER 
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Using Macros for Manual Document Assembly 


One method of manually implementing document macros is to use a 
crib sheet, as shown in Figure 9-18, that outlines the steps neces- 
sary to produce a letter. As the crib sheet shows, you first start with 
the ORDRPLY.WPM macro, which opens the main document 
template (ORDRPLY.TXT) and automatically enters the date. You 
then type the name and address of the customer, followed by a 
salutation. You now have three more steps, with several choices in 
each step. 


°Macro step number 2 enters boilerplate text for an inquiry or an 
order. You execute the TYINQ.WPM or TYORD.WPM macros ac- 


cordingly. 
°Macro step number 3 enters boilerplate text for full payment, pay- 
ment not enclosed, or payment insufficient. 


°Finally, macro step number 4 closes the letter, depending on 
whether it is an inquiry or order. The (ORDRPLY.TXT) notation 
on the bottom of the crib sheet tells you the template document 
used for the letter, and is retrieved by the ORDRPLY.WPM macro. 


Setting up the reply system, in this case for a fictitious book called 
"Successful Indoor Gardening On a Budget” (a "perennial" best- 
seller, to say the least!), requires you to create each macro and enter 
the text boilerplate you want included. The text of the macros is 
detailed in Figures 9-19 through 9-26 as a means of showing you 
the construction of the system. 

Note the (PROMPT) instruction in ORDRPLY.WPM. It displays, 
in bold letters, "Type the name and address.” The computer beeps 
and the prompt stays on the screen for two seconds (20/10ths of a 
second). 

Also note the (TEXT) instruction in the NSFPAY.WPM macro. It 
asks you to enter the amount due and press [Enter]. Your entry is 
stored in variable 1 and printed directly into the letter. The dollar 
sign is part of the macro so you don’t need to enter it yourself, but 
you do need to include any decimal points or commas. 

It would be nice to have WordPerfect calculate the balance due 
based on the amount remitted and the cost of book, but if you’re 
working with fractional numbers it can’t be done using variables. 
WordPerfect variables perform math with whole integers (numbers) 
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Letter/macro format for book orders/inquiries 


Macro Step Automatic entry Macro name 


Ls Open document, enter date (ordrply] 


Type the following: 


<name> 
<addresg> 
<city,state> 
<dear> 
Macro Step Automatic entry Macro name 
2. thanks for inquiry: [tyinq] 
or 
thanks for order: (tyord] 
3. your order is enclosed: [ordenc] 
or 
payment not enclosed: [nopay] 
or 
payment insufficient: [nsfpay] 
4. closing inquiry: [clingq] 
or 
closing order: {clord) 
(ORDRPLY. TXT) 


FIGURE 8-18 CRIB SHEET 
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{DISPLAY OFF) 
{Retrieve)ORDRPLY.TXT({Enter) 
{Rome} {Home) {Down} 


{DISPLAY ON} 
{PROMPT){*])}Type the name and adress {*\})~{BELL) (WAIT) 20~ 


FIGURE 9-19 TEXT FOR ORDRPLY.WPM MACRO 


{DISPLAY OFF) 

Thank you for your inquiry for our book, (Bold}Successful Indoor 
Gardening On a Budget {Bold}. We are enclosing a flyer that fully 
describes the book and its money-saving contents. We're sure 
that you will enjoy the many full color pictures and step-by-step 
gardening instructions, plus the handy fold-out climate chart 
that details the best climates and regions for specific types of 
indoor plants and shrubs. The $12.95 cover price for 
{Bold}Successful Indoor Gardening On a Budget {Bold} is small in 
comparison to the money you’1ll save on buying and growing your 
favorite garden vegetables. 

{Enter} {Enter} 

{DISPLAY ON) 


FIGURE 9-20 TEXT FOR TYINQ.WPM MACRO 


{DISPLAY OFF) 
Thank you for ordering our best-selling book, (Bold)Successful 


Indoor Gardening On a Budget{Bold). 
{DISPLAY ON} 


FIGURE 9-21 TEXT FOR TYORD.WPM MACRO 
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{DISPLAY OFF) 

Your copy is enclosed. We're sure that you will enjoy its many 
full color pictures and step-by-step gardening instructions, plus 
the handy fold-out climate chart that details the best climates 
and regions for specific types of indoor plants and shrubs. Your 


payment of $12.95 for (Bold)Successful Indoor Gardening On a 
Budget {Bold} is small in comparison to the money you’ll save on 
buying and growing your favorite garden vegetables. 

{Enter) (Enter) 

(DISPLAY ON} 


FIGURE 9-22 TEXT FOR ORDENC.WMP MACRO 


{DISPLAY OFF) 


We could find no payment for the book, however, and our company 
policy requires pre-payment on all orders. We are enclosing a 
flyer that fully describes the book and its money-saving 

contents. We're sure that you will enjoy the many full color 
pictures and step-by-step gardening instructions, plus the handy 
fold-out climate chart that details the best climates and regions 
for specific types of indoor plants and shrubs. The $12.95 cover 
price for {Bold})Successful Indoor Gardening On a Budget({Bold) is 
small in comparison to the money you'll save on buying and 
growing your favorite garden vegetables. 

{Enter) {Enter) 

(DISPLAY ON} 


FIGURE 9-23 TEXT FOR NOPAY.WPM MACRO 


(DISPLAY OFF) 


Sadly, we cannot ship your copy to you at this time because the 
amount on your check or money order is insufficient to cover the 
$12.15 sale price of the book. Our company policy requires full 
payvsīiz on all orders. We will be glad to ship {Bold}Successful 
Incocr vardening On a Budget{Bold} to you when we receive a 

4 .=nce payment of 

‘ai\T)l-Enter the amount due and press Enter. ~${VAR 1}. 

à postage-paid, self-addressed envelope is enclosed for your 
sonvenience. We have also enclosed a flyer that fully describes 
the book and its money-saving contents. We’re sure that you will 
enjoy the many full color pictures and step-by-step gardening 
instructions, plus the handy fold-out climate chart that details 
the best clirates and regions for specific types of indoor plants 
and shrubs. The $12.95 cover price for {Bold})Successful Indoor 
Gardening On a Budget{Bold} is small in comparison to the money 


you'll save on buying and growing your favorite garden 
vegetables. 


{Eater} {Enter} 
{DISPLAY ON} 


FIGURE 9-24 TEXT FOR NSFPAY.WPM MACRO 
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{DISPLAY OFF) 

We hope you will take the time now to complete the order form 
included with the flyer. If you are in a hurry, rest assured 
that we will rush your order to you within 48 hours of receipt of 
your payment. 

{Enter) {Enter} {Enter} 


Sincerely, {Enter} {Enter} {Enter) {Enter) 


John Drake, Publisher{Enter) 
enc. 

{DISPLAY ON) 

{Print}1l 

{Exit}nn 


FIGURE 9-25 TEXT FOR CLINQ.WPM MACRO 


{DISPLAY OFF) 


Again, thank you for your order. We appreciate your business and 
wish you success for indoor gardening on a budget. 
{Enter) {Enter) {Eneter} 


Sincerely, {Enter} {Enter} {Enter) {Enter} 


John Drake, Publisher{Enter} 
enc. 

{DISPLAY ON) 

{Print}1 

{Exit}nn 


FIGURE 9-26 TEXT FOR CLORD.WPM MACRO 


only; if you enter a decimal number, such as 7.95, WordPerfect treats 
it as text. 

Both CLINQ.WPM and CLORD.WPM include instructions to print 
the document after it has been assembled. Therefore, be sure that 
the printer is on and ready to go. This is important, because the 
macro clears the screen automatically after it has printed the page. 
If you prefer, you can delete the last instructions in order to print 
and clear the document manually. 

The format for the ORDRPLY.TXT document, shown in Figure 9— 
27, includes a letterhead embedded in the header. Delete the header 
if you are using letterhead paper stock. Formatting codes used in the 
document include: 
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April S, 1989 


Dt\UPSB\TEXT\ORDRPLY. TXT 
( 


Doc 1 Pg 1 Ln 1 Pos 18 


, E ERE 


[Pg Numbering:No page numbering](Center Pg] eee ea 
(Header At1;CURY LARGEJC(BOLDJCCntrJ INDOOR GARDENING BOOK CLUBCC/A“FIrtJICHRtI 
ooo SRt] 

CDate:3 1, 4]CHRtI 

CHRtIJ 

CHRtI 


Press Reveal Codes to restore screen 


FIGURE 9-27 ORDRPLY.TXT TEMPLATE, WITH CALLOUTS 


eNo page numbering. 
«Center page. 
¢Date text. 


Samples of two completed letters are shown in Figures 9-28 and 
9-29. Both were created and printed in less than one minute. 


Using Macros for Automatic Document Assembly 


A more streamlined version of the customer reply letter involves a 
main macro that includes one-line prompt menus and several branch 
macros that contain the boilerplate text you want to use. The sys- 
tem uses merge printing and a predefined primary document, named 
ORDPRI.MRG and illustrated in Figure 9—30, that comprises noth- 
ing but fields for entering the name and address of the customer. 
Although the example shown here is designed to produce reply let- 
ters for a fictitious product, you can readily modify the system to suit 
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INDOOR GARDENING BOOK CLUB 
5000-B 32nd St. 
New York, NY 10001 


June 15, 1988 


Bill Donahue 
1034 Elm Street 
Anytown, USA 12324 


Dear Mr. Donahue: 


Thank you for ordering our best-selling book, Successful Indoor 
Gardening On a Budget. Your copy is enclosed. We're sure that 
you will enjoy its many full color pictures and step-by-step 
gardening instructions, plus the handy fold-out climate chart 
that details the best climates and regions for specific types of 
indoor plants and shrubs. Your payment of $12.95 for Successful 
Indoor Gardening On a Budget is small in comparison to the money 
you'll save on buying and growing your favorite garden 
vegetables. 


Again, thank you for your order. We appreciate your business and 
wish you success for indoor gardening on a budget. 


Sincerely, 


John Drake, Publisher 
enc. 


FIGURE 9-28 SAMPLE ASSEMBLED DOCUMENT 1 
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INDOOR GARDENING BOOK CLUB 
5000-B 32nd St. 
New York, NY 1210001 


June 15, 1988 


Bill Donahue 
1034 Elm Street 
Anytown, USA 12324 


Dear Mr. Donahue: 


Thank you for ordering our best-selling book, Successful Indoor 
Gardening On a Budget. Sadly, we cannot ship your copy to you at 
this time because the amount on your check or money order is 
insufficient to cover the $12.95 sale price of the book. Our 
company policy requires full payment on all orders. We will be 
glad to ship Successful Indoor Gardening On a Budget to you when 
we receive a balance payment of $4.32. A postage-paid, self- 
addressed envelope is enclosed for your convenience. We have 
also enclosed a flyer that fully describes the book and its 
money-saving contents. We're sure that you will enjoy the many 
full color pictures and step-by-step gardening instructions, plus 
the handy fold-out climate chart that details the best climates 
and regions for specific types of indoor plants and shrubs. The 
912.95 cover price for Successful Indoor Gardening On a Budget is 
small in comparison to the money you'll save on buying and 

growing your favorite garden vegetables. 


Again, thank you for your order. We appreciate your business and 
wish you success for indoor gardening on a budget. 


Sincerely, 


John Drake, Publisher 
enc. 


FIGURE 98-29 SAMPLE ASSEMBLED DOCUMENT 2 
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your own requirements. If your modifications are extensive, consult 
Chapter 5 for an explanation of how to use macros to make on-screen 
menus. 


MRGORD.WPM (CHAP9 directory on Applications Disk) 
1. (LABEL}start~ 
2. (TEXT) 1~Enter first name. - -~(VAR 1)(4R) (Enter) 
(TEXT) 1~Enter last name. - -~(VAR 1){4R) {Enter} 
(TEXT) 1~Enter the company (if any). - -~(VAR 1) 
(AR) (Enter) 
(TEXT) 1~Enter the street address. : -~(VAR 1) 
(AR) (Enter) 
(TEXT) 1~Enter the city. --~(VAR 1)(‘R) (Enter) 
(TEXT) 1~Enter the state. --~(VAR 1}(4R}{Enter) 
(TEXT) 1~Enter the ZIP code. --~(VAR @TAB TURNOVER = 
1) (4R) (Enter) 
3. (LABEL) loop1~ 
(CHAR}1~Is this an: 1 Order; 2 Inquiry. - -?~ 
(IF)"(VAR 1}"="1"~(NEST)+yord~(GO)orderbody~ 


FIGURE 9-30 AUTO-ASSEMBLE TEMPLATE 


^F37^ 

“F4* 

^F5^, ^F6^ “FS 
Dear ^F1^ ^F2^: 


^Fg^ 


Dt\WPSG\TEXT\ORDPRI. MRG Doc 1 Pg i Ln 1 Pos 10 
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4. 


OT 


(ep) 


(ELSE) 
(F)"(VAR1)"="2"~{(NEST)tying~(NEST)closinq~ 
(GO)sig~ 

(ELSE) 

(END IF)(END IF) 

(PROMPT)Press 1 or 2. - -~(BELL} (WAIT) 15~(GO}loop1~ 
(LABEL) orderbody~ 

(LABEL) loop2~ 

(CHAR)1~1 Order is complete; 2 No money; 3 
Insufficient payment. - -~ 
(IF)"(VAR1')="1"~(NEST)ordenc~(NEST)clord~ 
(GO}sig~ 

(ELSE) 

(IF}"(VAR 1')="2"~(NEST})}nopay~(NEST])cling~ 
(GO)sig~ 

(ELSE) 

(IE}"(VAR 1J="3"~(NEST)nsfpy~(NEST}clinq~{GO)sig~ 
(ELSE) 

(END IF) (END IF)(END IF) 

(PROMPT) Press 1, 

2, or 3. - -~{BELL) (WAIT) 15~ 

(GO)loop2~ 


. (LABEL) sig~ (Enter) (Enter) 


Sincerely, (Enter) (Enter) {Enter} (Enter) 
John Drake({Enter)enc.(“R) {Enter} 
(^E) (H Pg) 


. (LABEL) doanother~ 


(CHAR) 1~Do another?: -(y/n)~ 
(IF)"(VAR 1)"="y"~(GO)start~ 

(ELSE) 

(IF)"(VAR 1)"="Y"~(GO)start~ 

(ELSE) 

(IF}"(VAR 1)"="n"~{GO)merge~ 
(ELSE) 

(IF}"(VAR 1)"="N"~(GO)merge~ 
(ELSE) 

(END IF){END IF) (END IF) {END IF) 
(PROMPT)Press y or n. - -~ (BELL) (WAIT}15~ (GO}doanother~ 


7. (LABEL)merge~ 


(Save, ORDSEC.MRG({Enter} 
(IF) (STATE) &1024~y(GO)startmrg~ 
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(ELSE) (GO)startmrg~ 
(END IF) 

8. ({LABEL}startmrg~ 
{Exit}nn 
(Merge/Sort}1 
ORDPRI.MRG{(Enter) 
ORDSEC.MRG (Enter) 


°Step 1 is a label used to repeat the macro if you want to do another 
letter. 


°oStep 2 asks for the name and address of the customer. Your entries 
are stored in variable 1, then printed directly into the document. 
Each entry is terminated with the “R merge code and a hard 
return. 


°Step 3 asks if the letter is for an order or an inquiry. If you press 
1 (order), the macro nests off to the TYORD.WPM macro. When 
TYORD.WPM macro is finished, the macro returns and jumps to 
the “orderbody" label. If you press 2 (inquiry), the macro nests off 
to the TYINQ.WPM macro, returns, then nests to the 
CLINQ.WPM macro. Finally, WordPerfect returns to the main 
macro and jumps to the "sig" label. If you press a key other than 
1 or 2, the macro displays a prompt and the loop is repeated. 


Step 4 asks if the order is complete (1), didn’t include money (2), 
or has insufficient payment (8). WordPerfect temporarily 
branches off to other macros depending on the choice you select. 


¢Step 5 prints the closing of the letter and adds the ^E merge code 
and a hard page. 


¢Step 6 asks if you want to do another letter. Answering yes returns 
you to the top of the macro and the process is repeated. Answer- 
ing no jumps the macro to the "merge" label. Note that the 
IF. ..ELSE instructions look for both lower and upper case Ys and 
Ns. 


eStep 7 starts the merge operation, but first saves the data you’ve 
just created in a file named ORDSEC.MRG. If the file already ex- 
ists, WordPerfect presents a Yes/No prompt (asking if you want 
to replace the file already on the disk); the Yes/No prompt is tested 
by the (STATE) instruction. If there is no prompt, the macro jumps 
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directly to the "startmrg” label. If there is a prompt, the macro 
answers with a y, then goes to the 'startmrg’ label. 

Step 8 executes the actual merge. The macro clears the screen, 
calls up the Merge/Sort menu, then specifies the primary and 
secondary files. The merged documents are displayed on the 
screen and can now be printed. 


The MRGORD.WPM macro uses test macros that are almost iden- 


tical to the manual document assembly system discussed earlier in 
the chapter. 


Reply Letters With Automatic Labels 


With the reply letter prepared, it’s now time to send it off in the 
mail—but wait! You still must address the envelope so the letter gets 
to its proper destination. You don’t want to handwrite the address 
because that looks tacky; and it’s a waste of time to retype them 
manually onto label stock. Since you already entered the name and 
address for the letter, why not use the same information to prepare 
quick mailing labels from within WordPerfect? 

You need a primary merge document that contains the fields and 
formatting for the label stock. The construction of the primary label 
document is shown at the end of this section. Rewrite the 
beginning and end of the automatic document assembly macro, 
MRGORD.WPM, as shown. Create a copy of MRGORD.WPM and 
name it MRGORD1.WPM. You can copy files from within Word- 
Perfect or with DOS. 

Edit the first lines of MRGORD1.WPM as follows: 


(LABEL)start~ 

(TEXT)2~Enter first name. - -~(VAR 2) (^R) (Enter) 
(TEXT)3~Enter last name. --~{(VAR 3)(*R) (Enter) 
(TEXT}4~Enter the company (if any). - -~(VAR 4) (^R) (Enter) 
(TEXT}5~Enter the street address. - -~(VAR 5)}(4R)} (Enter) 
(TEXT}6~Enter the city. - -~(VAR 6) (4R) (Enter) 
(TEXT)7~Enter the state. --~(VAR 7}(*R) (Enter) 


(TEXT]8~Enter the ZIP code. - -~(VAR 8)(4R) (Enter) 
(CALL) addlabel~ 
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The major change in the code is the variable numbers for each 
(TEXT) instruction. Once assigned with a value (in this case a text 
string), the variables hold the information until the macro is com- 
plete. The {CALL) instruction, also new to this version, temporarily 
branches the macro off to the subroutine "addlabel." 

Add these lines to end end of the macro (following the line, 
“ORDSEC.MRG(Enter)" in MRGORD.WPM): 


1. (GO) mrglabel~ 

2. (LABEL) addlabel~ 
(Switch) 
(VAR 2) (^R) (Enter} 
(VAR 3)(4R) (Enter} 
(VAR 4) (^R) (Enter) 
(VAR 5) (^R) (Enter) 
(VAR 6) {^R} (Enter) 
(VAR 7} (^R) (Enter) 
(VAR 8) (*R) (Enter) 
(^E) (H Pg) 
(Switch) 
(RETURN) 

3. {LABEL)mrglabel~ 
(Switch) 
(Save LABELSEC.MRG(Enter] 
{IF} (STATE) &1024~y(GO)dolabel~ 
(ELSE) (GO) dolabel~ 
(END IF) 

4. (LABEL) dolabel~ 
(Exit)}nn 
(Merge/Sort)1 
LABELPRI.MRG(Enter) 
LABELSEC.MRG{Enter} 


e After the letters have been merged, Step 1 jumps the macro to the 
“mrglabel" routine. 

eStep 2 is the "addlabel” subroutine. It prints, in Doc 2, the secon- 
dary file for producing the labels. Each field ends with a “R and 
an (Enter) code; each record ends with a ^E code and a (HPg} code. 
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^F1^ OFS 


A A 


^FS^, ^F6^ a BF ad 
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FIGURE9-31 LABELPRIL.MRG LABEL TEMPLATE 


‘Step 3 is the "mrglabel" routine. It merely saves the names and 
addresses into a file named LABELSEC.MRG. 


*Step 4 is the continuation of the merge label routine. It actually 
merges the primary label file (LABELPRI.MRG) with the secon- 
dary label file (LABELSEC.MRG). 


Doc 1 now holds the letters, ready for printing; Doc 2 now holds 
the labels, ready for printing. With fan-fold paper or stationery in 
the printer, print the contents of Doc 1. Switch over to Doc 2, change 
the paper to label stock, and print. 

The LABELPRI.MRG file is shown in Figure 9-31, and is made to 
work with standard 1 by 3 inch, one-up labels. The fields show the 
layout for the name and address. To accommodate the label stock, 
make these format changes in the LABELPRI.MRG document. 


Top Margin = .25" 
*Bottom Margin = 0" 


*Left Margin = 0.10" (print starts at left edge of carriage) 
ePaper Size = 3" (width) by 1" (height) 
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° Paper Type = Label 


°No page numbering 


Be sure to set the new margins before setting the paper size. If 
you have already created a label form (using WordPerfect’s Form fea- 
ture), choose it from within the Format menu instead of manually 
entering the page size and type. At printing, WordPerfect will stop 
and ask you to change paper stock. To start the actual printing: 


Key Sequence What it Does 
1. [Shift]-[F7] Chooses Print command. 
2.5 Selects Control Printer option (the current 
print job is shown waiting in the queue), 
3.4 Chooses Go option; printing starts. 
CONTRACTS 


If you write more than a couple of contracts a month, you know how 
of much of a hassle the work can be. The legal ramifications of 
making a mistake require you to carefully prepare and produce each 
contract you write with WordPerfect. Using macros or merges can 
help ease the burden, but unless your contracts are very simple, or 
don’t involve many variables, your chances of making errors and 
entering the wrong data is profoundly increased. 

An on-screen menu system coupled with nested macros makes 
producing boilerplate contracts relatively painless—and far more ac- 
curate. You can construct your contracts so that the standard 
boilerplate text is entered automatically, yet you are still given a 
chance to enter information that may change from contract to con- 
tract. 

To explain how macros can be used to produce a contract, let’s ex- 
amine the author’s agreement in Figure 9-32. Although it shows 
only the first page of an eight-page contract, it offers a good example 
of the entire process. At the heart of the contract is the CON- 
TRACT.WPM macro, which serves aS a menu engine. The engine 
uses a Separate menu list document, CONTRACT.MEN, illustrated 
in Figure 9—33. The menu just about fills the screen with 22 items, 
although the system is designed so that you can have more items 
than will fit on one screen 
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AGREEMENT 


AGREEMENT made this Fifth day of February, 1989, between Roger 
Kaputnick, 1010 Featherhill, Westport, CT 06880, hereinafter 
called Author, and MIRACLE BOOKS, INC., 123 Main Street, Los 
Angeles, CA 90023, hereinafter called Publisher. 


The parties hereto agree as follows: 


l. PUBLISHING RIGHTS 


Author hereby grants and assigns exclusively to Publisher, during 
the full term of copyright of the work, the world publishing 


English-language rights to publish and sell a Work tentatively 
called 


DESKTOP PUBLISHING WITH THE OSBORNE 1 


including all revisions and future editions thereof; the rights 
to all subsidiary rights to said Work as defined in and subject 
to provisions in Paragraph ? below; the right to copyright 

throughout the world in the name of the Author. Copyright shall 


be taken out upon first publication by the Publisher at its own 
expense. 


2. WARRANTY 


Author represents and warrants that he/she is the author and 
proprietor and sole owner of all rights in the Work, that the 
Work is original except for such excerpts from copyrighted works 
as may be included with the permission of the copyright owner 
thereof, that it does not violate the right of privacy of or 
libel any person, that it does not infringe any copyright, 
trademark, patent, or any right of others, and that any formulas, 
processes, and directions originated or devised by Author and 
used in the Work are safe and the Author has full power to make 
this agreement. Author agrees to indemnify and hold harmless 


Publisher from all costs, expenses, and damages arising from any 
breach of such warranty. 


FIGURE 9-32 FIRST PAGE OF AUTHOR’S AGREEMENT CONTRACT 
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Beginning of Contract begin 
Publishing Rights pubrite 
VYarranty warranty 
Manuscript mscript 
Copyrighted Material copyrlite 
Publishing publish 
Royalties royalty 
York for Hire Agreement vorkhire 
Rights 

Agency 

Statements 

Examination of Accounts 

Author’s Corrections 

Author’s Copies 

Competing Works 

Revised Editions revision 


OOND A WNI 


Out of Print outpnt 
Assignments assign 
Next Work nextuork 
Binding Agreement agree 
Applicable Lau law 
Close close 


D: \UWPSG\TEXT\CONTRACT. MEN Doc 1 Pg 1 Ln 1 Pos 1@ 


FIGURE 9-33 CONTRACT.MEN 


The unique aspect of the CONTRACT.WPM macro is that it high- 
lights each menu item as you press the [Up] and [Down] cursor 
keys. After selecting a menu option, you simply press [Enter] and 
the corresponding boilerplate macro is activated. After the 
boilerplate macro is finished, you are returned to the list where you 
left off. When you are done, press [Ctrl]-C, and the CON- 
TRACT.WPM macro ends. The menu list is cleared, and you are 
presented with the completed contract. 

The author’s agreement, like most "casual" contracts, uses num- 
bered paragraphs (as opposed to numbered lines), These paragraphs 
are labeled by name so that WordPerfect can automatically reference 
the paragraph numbers. For example, note the paragraph reference 
in the fourth line from the end of "Publishing Rights." This reference 
ties the "rights" paragraph (in this case, Paragraph 6), that appears 
later in the contract. 

The system of automatic referencing, which makes use of 
WordPerfect’s feature of the same name, as well as the menu-driven 
engine of the macro, allows you to link the paragraphs of the con- 
tract in any order you wish. The paragraph numbers and auto- 
reference numbers are provided by WordPerfect, relieving you of 
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WUONOMN A WNE 


Beginning of Contract begin 
Publishing Rights pubrite 
Warranty warranty 
Manuscript mscript 
Copyrighted Material copyrite 
Publishing publish 
Royalties royalty 
Work for Hire Agreement vorkhire 
Rights rights 
Agency agency 
Statements stment 
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SCTab)CTabJCopyrighted Material(TabJcopyritel Tab]CHRt] 
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6(TabJ(TablWork for Hire Agreementl£ TablworkhirelTabJCHRt) 
SCTabICTabIRights(TabIrightslTabJCHRt] 


Press Reveal Codes to restore screen 


FIGURE 8-84 SPECIAL TABS FOR CONTRACT.MEN 


keeping track of them yourself. This helps makes the system even 
more foolproof and easy to use. 


Please note that only the first three paragraph options of the sup- 
plied macro are active. 


The Contract Macro and List Menu 


The CONTRACT.WPM macro engine is fairly straightforward. Its 
construction allows you to use it with any menu-based system. Just 
change the name of the menu list file (CONTRACT.MEN in the ex- 
ample) as required. To work properly, your menu list file should be 
formatted the same as CONTRACT.MEN. This formatting consists 


of the tab settings shown in Figure 9-34 and the organization of the 
menu items in the list. 


*The first column displays a menu number, and isn’t really used 
for anything special. 


*The second column displays a description of the boilerplate macro. 


*The third column displays the actual name of the macro. 
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The menu list should contain no empty lines. 
CONTRACT.WPM (CHAP9 directory on Applications Disk) 


1. (ON ERROR)~(Switch) 
2. (Retrieve, CONTRACT.MEN (Enter) 
3. (DISPLAY ON) 
{Home) {Home}(Up) 
(ASSIGN) 0~~ 
(GO)highlight~ 
4. (LABEL) loop~ 
{LOOK} 0~ 
(IF)" (VAR 0}"="(Down)"~(Block) (Home) (Left) (Down) 
(GO)highlight~ 
(ELSE) 
(IF)" (VAR 0)"="{Up)"~(Block) (Home) (Left) (Up) 
(GO)highlight~ (IF)"(VAR 0)"="(Enter)"~(Block) (Word 
Left) (Block) 
(ELSE) 
(Word Right) (Macro Commands}32(Switch) (NEST) 
(VAR 2}~{Enter) (DISPLAY ON) (Switch) (Block) 
(Home) (Left) (Up) (GO)}loop~ 
(ELSE) 
(IF}"(VAR 0)}"="(4C)"~(Block) (Exat}nn (Switch) 
(DISPLAY OFF) (Mark Text)65(Enter) (DISPLAY ON} 
(QUIT) 
(ELSE) 
(END IF){END IF)(END IFP (END IF) 
(GO}loop~ 
5. (LABEL)highlight~ 
{Block} (End) 
(GO) loop~ 


¢Step 1 tells the macro to issue an error. Without this statement, 
an error during macro execution causes the macro to stop. It is 
used primarily, in the example, to prevent the macro from stop- 
ping prematurely if you select a macro file that doesn’t yet exist. 
The macro then switches to DOC 2 which is used as a scratchpad 
for the CONTRACT.TPM menu document (DOC 2 should be clear 
before starting the macro). 
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¢Step 2 retrieves the menu list document, CONTRACT.MEN. 


Step 3 assigns an empty value to variable 0, which is used to scan 
for key presses. 


¢Step 4 comprises four IF... .ELSE structures. The macro looks for 
your different key presses, [Up], [Down], [Ctrl]-C, and [Enter]. 
When the macro encounters these, it performs the instructions 
immediately following the IF statement. If one of these keys isn’t 
pressed, the loop continues. In the case of pressing the [Up] and 
[Down] keys, the macro moves the cursor to the left margin and 
down one line, then jumps to the “highlight” routine. 


In the case of the [Enter] key, WordPerfect selects the macro 
name at the end of the menu line and nests to that macro. In the 
case of pressing [Ctrl]-C (finish), WordPerfect clears the menu 
list, switches to the contract screen, then generates the automatic 
references. 


¢Step 5 highlights the selected line, then jumps back to the "loop" 
routine. 


The macro selects or highlights, with the block function, each line 
in the menu list. Pressing the [Down] or [Up] keys moves the selec- 
tion up or down. If you have more than about 24 items in the menu, 
the screen will scroll as you press the cursor keys. When you get to 
the line you want, pressing [Enter] reduces the block selection to 
the last column, which contains the actual name of the macro. To 
end the macro, press [CTRL]-C. You can restart the contract at any 
time by displaying the text you have created so far; and invoking the 
CONTRACT.WPM macro again. 


The Contract Sub-macros 


Each menu item refers to a separate macro. For example, the "Begin- 
ning of Contract” menu item calls up BEGIN.WPM. The design of 
the contract system allows you to use fairly descriptive names for 
each menu item yet still refers to each individual macro by its name 
of eight or less characters. 

You are free to be as elaborate as you want in the construction of 
the sub-macros, but remember that they are themselves nested 
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macros. Each nested macro can chain to only one additional macro. 
The following macros show the first three sections of the author’s 
agreement contract. Note that with the exception of the first section, 
the paragraph numbering and auto-referencing features are used to 
identify the paragraphs. The Date/Outline instruction in 
BEGIN.WPM formats the paragraph numbering using decimal 
numerals. Only three sub-macros are included on the Applications 
Disk: BEGIN.WPM, PUBRITE.WPM, and WARRANTY.WPM. 
Selecting another sub-macro in the CONTRACT.WPM menu will 
Result in an error, but the macro will automatically restart and let 
you make another selection. 


BEGIN.WPM (CHAP9 directory on Applications Disk) 


1. (DISPLAY OFF} 
{(Date/Outline)62(Enter} (Enter) 
(Enter) 
(Center} (Bold AGREEMENT (Bold) (Enter) (Enter) 
(Enter) 
2. AGREEMENT made this.(DISPLAY ON) 
(TEXT}2~Enter date. - :-~ 
(VAR 2}, between. 
{TEXT}2~Enter author name and address. : -~ (VAR 2), 
hereinafter called Author, and MIRACLE BOOKS, Inc., 
123 Main Street, Los Angeles, CA 90023, hereinafter 
called Publisher. {Enter} (Enter) 
The parties hereto agree as follows:(Enter) {Enter} 


Step 1 turns the display off, sets the paragraph numbering defini- 
tion to decimal (arabic) numerals, and prints AGREEMENT in 
bold letters at the top, center of the page. 


Step 2 starts the agreement text, then stops for you to enter the 
date. Your entry is stored in variable 2, then printed out when you 
press the [Enter] key. The process is repeated to allow you to 
enter the name and address of the author. 


Note that while entering the name and address after the status 
line prompt, WordPerfect will wrap the entry to the next line, but it 
may not break the line at a word. Though this looks awkward on the 


228 WordPerfect 5.0 Macros and Templates 


screen, the text will be formatted correctly in the document. Don’t 
press the [Enter] key yourself to start a new line. 

In addition, the screen will scroll up with each new line, aad this 
could cause the text display to show duplicate lines. These lines are 
"ghosts" and will disappear when the screen is rewritten. 


PUBRITE.WPM (CHAP9 directory on Applications Disk) 

1. (DISPLAY OFF) 

(Date/Outline}5 (Enter) 
(Mark Text) 12pubrites{(Enter) 

2. (Tab PUBLISHING RIGHTS) {Enter} (Enter) 

Author hereby grants and assigns exclusively to Publisher, 
during the full term of copyright of the Work, the world 
publishing English-language rights to publish and sell a 
Work tentatively called{Enter) (Enter) (DISPLAY ON} 

3. (TEXT)2~Enter the name of the work. - -~ 
(Bold) (VAR 2} (Bold) (Enter) {Enter} 

4, (DISPLAY OF Fjincluding all revisions and future editions 
thereof; the rights to all subsidiary rights to said Work as 
defined in and subject to revisions in Paragraph 

5. (Mark Text)112nghts{Enter} 

6. below; the right to copyright throughout the world in the 
name of the Author. Copyright shall be taken out upon first 
publication by the Publisher at its own expense.{Enter} 
(Enter) (DISPLAY ON} 


Step 1 turns the display off and enters an automatic paragraph 
numbering code. It also marks the paragraph as a target for 
WordPerfect’s auto-referencing function. In this case, the target 
name is 'pubrites." 

«Step 2 starts the PUBLISHING RIGHTS paragraph. 
eStep 3 pauses to allow you to enter the name of the work. It is 
printed on the page in bold. 

«Step 4 continues the PUBLISHING RIGHTS paragraph. 

*Step 5 interjects an auto-referencing code to the "rights" 
paragraph, which appears later in the contract. 


*Step 6 concludes the PUBLISHING RIGHTS paragraph. 
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WARRANTY.WPM (CHAP$9 directory on Applications Disk) 
1. (DISPLAY OFF) 
(Date/Outline)5(Enter) 
(Mark Text) 12warranty(Enter} 
2. (Tab) WARRANTY (Enter) 
Author represents and warrants that he/she is the author and 
proprietor and sole owner of all rights in the Work, that the 
Work is original except for such excerpts from copyrighted 
material as may be included with the permission of the 
copyright owner thereof, that it does not violate the right of 
privacy of or libel any person, that it does not infringe any 
copyright, trademark, patent, or any right of others, and that 
any formulas, processes, and directions originated or devised 
by Author and used in the Work are safe and the Author has 
full power to make this agreement. 
3. {CHAR})0~Include Indemnity Clause? (y/n)~ 
(IF)"(VAR 0}"="y"~{GO)clause~ 
(ELSE) (Enter) (Enter(RETURN} 
{END IF} 
(LABEL)clause~ 
--Author agrees to indemnify and hold harmless Publisher from 
all costs, expenses, and damages arising from any breach of 
such warranty. {Enter) (Enter) 


°Step 1 turns the display off and enters an automatic paragraph 
numbering code. It also marks the paragraph as a target for 
WordPerfect’s auto-referencing function. In this case, the target 
name is "warranty." 


eStep 2 starts the WARRANTY paragraph. 


Step 3 asks if you want to include the indemnity clause. Pressing 
the y key inserts the text; pressing any other key skips over the 
text. 


Of course, your contracts will contain different text and may re- 
quire you to enter more variable information. Whenever you need to 
enter data or make a choice, add a (TEXT) instruction within the 
text, then plant the answer in the paragraph using (VAR X), as 
shown in the previous examples. 

Once the contract is complete, you should check to make sure that 
the paragraph and auto-referencing numbers are correct, then print 
it out for final review. 


CHAPTER 10 


DESKTOP 
PUBLISHING 


O.. of the latest personal computer crazes is desktop publishing, 
a process of using your computer to publish books, newsletters, 
magazines, and other documents printed for distribution to others. 
While WordPerfect is not a true desktop publishing program, ver- 
sion 5.0 has features that help you create sophisticated, production- 
quality documents. 

Macros, styles, and templates find a comfortable home in desktop 
publishing, particularly if you are preparing a periodical or a 
regularly issued newsletter. This chapter contains numerous ex- 
amples of using WordPerfect as a desktop publishing tool: 


¢Format styles for two-, three-, and four-column documents. 
e Reusable template documents with standing elements. 


eMacros for formats, fonts, and graphics. 
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HARDWARE REQUIREMENTS 


Desktop publishing is a visual art that relies heavily on the 
computer’s ability to reproduce on screen, as nearly as possible, how 
the finished page will look when printed. This visual fidelity is often 
referred to by its funny-sounding acronym: WYSIWYG— 
(pronounced "wizzy-wig') short for "what-you-see-is-what-you-get." 
If your desktop publishing requirements are simple and straightfor- 
ward, requiring nothing more than formatting same-size text into 
columns, you can use WordPerfect with just about any IBM PC 
hardware configuration. 

But if you want to add graphics, or preview font, sizes, and styles, 
you need a graphics display adapter and suitable monitor. Word- 
Perfect and desktop publishing get along well when using one the 
following graphics adapters: 


¢Hercules monochrome—The Hercules graphics card is an excel- 
lent, inexpensive approach to serious desktop publishing. You can 
use a regular TTL monochrome monitor with a Hercules or Her- 
cules-compatible card. WordPerfect also comes with special font 
drivers for displaying enhanced text using the Hercules Card 
Plus. 


Color graphics adapter (CGA)—The CGA is a low-resolution 
graphics adapter that’s only marginally suitable for desktop 
publishing. Graphics and fine-detailed fonts are difficult to see. 
The CGA uses a standard RGB color monitor. 


Enhanced graphics adapter (EGA). Although somewhat old tech- 
nologically, the EGA is the most popular display adapter current- 
ly in use. It has sufficient resolution to display fine detail and 
offers a wide Selection of simultaneous colors. The EGA works only 
with EGA-compatible RGB color monitors. 


¢Video graphics array (VGA)—The newest and most capable dis- 
play adapter is the VGA, now found on most IBM PS/2 computers 
and offered as an add-in card by other manufacturers. The display 
resolution is very high, making the VGA excellent for desktop 
publishing. Many third-party VGA-compatible cards function as 
several adapters, typically Hercules graphics, CGA, EGA, and 
VGA. The VGA graphics standard requires a high resolution 
analog/digital color monitor. Many owners of VGA cards use a 
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multiple-frequency color monitor that adapts to any of the exist- 
ing IBM PC graphics standards. 


Because desktop publishing is graphics oriented, character 
printers, such as the time-honored daisywheel, are unsuitable for 
anything more than printing columns of standard text. Most dot 
matrix printers are capable of graphics, but their resolution is suf- 
ficiently poor that the results are unsatisfactory. Though they are 
costly, the printer of choice in the desktop publishing arena is the 
laser. 

Laser printers produce very high resolution—approaching typeset 
quality—and they are able to mix text and graphics freely on the 
same page. WordPerfect works with most laser printers now out, in- 
cluding the Apple LaserWriter and the Hewlett-Packard LaserJet II 
(as well as all laser printers that are compatible with these two 
popular models). Laser printers sport either built-in (cartridge or 
permanent) or downloadable fonts. This allows you to experiment 
freely with fonts, sizes, and styles for your document. You can make 
each character smaller than an ant or as large as the entire page! 

The examples that follow assume you are using a laser printer, 
specifically the LaserWriter, for your desktop publishing applica- 
tions. Even if you don’t own a laser printer, you can still view the 
results of your efforts using the Print View command (but you must 
have a graphics-compatible display adapter and monitor). You will 
see the finished page, complete with text and graphics, exactly as it 
will appear when printed. Prior to laying out the page, select the 
Apple LaserWriter printer driver, using the Select option found in 
the Print menu. 


COLUMN FORMATS 


Desktop published documents are generally formatted into columns. 
WordPerfect allows you to set up to 24 columns per page, although 
the practical maximum for standard 8 1/2 by 11 inch paper is four 
columns. Any more and the page looks crowded and awkward. By 
using the Newspaper column format, text you enter into one column 
automatically flows to the next when you reach the bottom margin; 
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and, when a page is full, WordPerfect creates a new page and begins 
filling it with columns. 

If you plan on getting serious about desktop publishing, you'll 
want to record your favorite column settings as styles.The following 
pages contain eight multiple column styles you can use for your own 
work. Each style differs in the number of columns, column width, 
column spacing, and tab settings. All assume a standard 8 1/2 by 11 
inch page. Feel free to adapt these styles any way you like. 

Figure 10-1 shows an example of the Two Column, Style A format 
as shown in the style definition window. The margin, tab set, and 
column definition codes, along with a column on code, should be 
placed before the comment. A column off code is entered after the 
comment. These style formats are included in the columns:sty file, 
found in CHAP10 directory on the Applications Disk. 


FIGURE10-1 SAMPLE COLUMN STYLE DEFINITION 
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Two Columns, Style A 

Left Margin Setting: 0.5" 

Right Margin Setting: 0.5" 

Tab Set: 0", 0.8", 4.7" 

Column Definition: 
Newspaper style 
Two columns 
0.5" spacing between columns 
Column 1 Margins: 0.5" Left; 4" Right 
Column 2 Margins: 4.5" Left; 8" Right 


Two Columns, Style B 
Left Margin Setting: 0.75" 
Right Margin Setting: 0.75" 
Tab Set: 0", 1.05", 4.95" 
Column Definition: 
Newspaper style 
Two columns 
0.75" spacing between columns 
Column 1 Margins: 0.75" Left; 3.87" Right 
Column 2 Margins: 4.62" Left; 7.75" Right 


Two Columns, Style C 
Left Margin Setting: 0.75" 
Right Margin Setting: 1.0" 
Tab Set: 1.05, 3.6" 
Column Definition: 
Newspaper style 
Two columns 
0.75" spacing between columns 
Column 1 Margins: 0.75" Left; 3.87" Right 
Column 2 Margins: 4.37" Left; 7.5" Right 


Two Columns, Style D 
Left Margin Setting: 1.0" 
Right Margin Setting: 1.0" 
Tab Set: 0", 0.5" | 
Column Definition: 
Newspaper style 
Two columns 
1" spacing between columns 
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Column 1 Margins: 1.0" Left; 4" Right 
Column 2 Margins: 4.5" Left; 7.5" Right 


Three Columns, Style A 

Left Margin Setting: 0.5" 

Right Margin Setting: 0.5" 

Tab Set: 0.8", 3.4", 6.1" 

Column Definition: 
Newspaper style 
Three columns 
0.5" spacing between columns 
Column 1 Margins: 0.5" Left; 2.66" Right 
Column 2 Margins: 3.16" Left; 5.33" Right 
Column 3 Margins: 5.83" Left; 8" Right 


Three Columns, Style B 

Left Margin Setting: 0.75" 

Right Margin Setting: 0.75" 

Tab Set: 1.05", 3.5", 6" 

Column Definition: 
Newspaper style 
Three columns 
0.75" spacing between columns 
Column 1 Margins: 0.75" Left; 2.75" Right 
Column 2 Margins: 3.25" Left; 5.25" Right 
Column 3 Margins: 5.75" Left; 7.75" Right 


Three Columns, Style C 

Left Margin Setting: 0.75" 

Right Margin Setting: 0.75" 

Tab Set: No tabs 

Column Definition: 
Newspaper style 
Three columns 
0.75" spacing between columns 
Column 1 Margins: 0.75" Left; 2.75" Right 
Column 2 Margins: 3.25" Left; 5.25" Right 
Column 3 Margins: 5.75" Left; 7.75" Right 


Four Columns 
Left Margin Setting: 0.5" 
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Right Margin Setting: 0.5" 

Tab Set: No tabs 

Column Definition: 
Parallel style, with Block Protect 
Three columns 
0.5" spacing between columns | 
Column 1 Margins: 0.5" Left; 2.0" Right 
Column 2 Margins: 2.5" Left; 4.0" Right 
Column 3 Margins: 4.5" Left; 6.0" Right 
Column 4 Margins: 6.5" Left; 8" Right 


Adding Additional Formats to Styles 


You can place any formatting codes you like in the column styles. 
These include codes for setting fonts and font size, justification, line 
spacing, and more. This comes in handy when you are preparing a 
regular newsletter, always using the same font and column styles. 


DESKTOP PUBLISHING TEMPLATES 


Magazines, newspapers, and newsletters that are published regular- 
ly throughout the year typically use the same format from issue to 
issue. One of the toughest jobs of desktop publishing is coming up 
with a clean, workable format. Once you have that format completed, 
it’s a waste of effort to reconstruct it or redesign it for each issue. 
Templates allow you to store a "blank" of your publication so that 
you can use it for every new issue. You may also create what's known 
in the publishing industry as "standing elements, pieces of text or 
artwork that are reused for each issue. A typical standing element 
is the banner or logo of a newsletter. 

If your documents use different formats for some of the pages, 
you'll need to create several template documents for each format. Or, 
in the case of a newsletter or other publication where articles may 
span several pages, you'll want to define formats to specific pages in 
the document. In a four-page newsletter, for example, the format for 
the first page will be completely different than the format for the 
second page. Pages 2, 3, and 4 may share a format, depending on 
your design. 
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The easiest way to prepare a template is to complete an issue of 
your newsletter or other publication, then strip out all the text. 
Leave only those elements that will stay from issue to issue, as well 
as any formats and styles. If necessary, add a short one or two-line 
description of the type of text that goes into each empty slot. When 
you are ready to assemble the next issue, delete the remaining lines 
of text and write or paste in the new material. 

Figure 10-2 shows the first page of a typical newsletter; The page 
consists of a graphic banner, with logo, at the top, and is divided into 
three newspaper-style columns. The material above the two article 
headlines, with the exception of the lines and issue date, are actual- 
ly contained in the header. The header is turned on for the first page 
only. The header (as well as the footer) is a place to stuff standing 
elements that assemble into one unit. Another approach to entering 
an assemblage of standing elements quickly is to store them in a 
style, and if necessary, update the style for each issue. 

The page consists of two graphics boxes: one is defined as a text 
box and contains the "Contents" information. A ten percent gray 
background is added to set the box off from the rest of the text. The 
other box is an empty blank that can contain a graphic or a con- 


FIGURE10-2 SAMPLE NEWSLETTER PAGE 
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tinuous-tone, screened photograph (added prior to printing the issue 
at the press). 

The contents box is a standing element, but rather than leaving it 
on the page in the template document, it is included as a style. After 
the basic text for the page has been entered, the text box style is in- 
serted at the appropriate spot in the bottom of the first column. The 
graphics box is handled the same way. 

You have a choice of four types of graphics boxes—figure, table 
text, and user-defined. WordPerfect allows you to modify the size 
and format of the box as you see fit. Each box type includes an Op- 
tions menu (Figure 10-3) where you can, among other things, set the 
border type and width, background shading, and horizontal spacing. 

When defining text in a text box, WordPerfect allows you to rotate 
it in even, 90-degree increments. You can use this feature to write a 
sideways logo, as shown in Figure 10-4. 

Use the vertical and horizontal position options in the box defini- 
tion window to set the placement on the page. If the box is smaller 
than the width of the column, you can instruct WordPerfect to wrap 
text around it. Figure 10-5 shows the effect of wrapped text when a 
graphic box is placed along the left and right margins of a column. 


DESKTOP PUBLISHING MACROS 


The nature of desktop publishing, where every application is dif- 
ferent and much of the work is original from issue to issue, reduces 
some of the effectiveness of macros. That doesn’t mean, however, 
that you can’t develop macros to help automate some of your desktop 
publishing tasks. Here are some examples: 


Defining Graphics Boxes 


WordPerfect insists you go through a rather elaborate chain of com- 
mands to create or edit graphics boxes. You can eliminate some 
keystrokes by assigning these duties to macros. You should define a 
different macro for each type of box you create. 
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Options: Figure 


1 — Border Style 


Left Single 
Right Single 
Top Single 
Bottom Single 
2 — Outside Border Space 
Left 0.16” 
Right 8.16" 
Top 0.16” 
Bottom 9.16” 
3 — Inside Border Space 
Left B” 
Right g” 
Top g” 
Bottom g” 
4 — First Level Numbering Mathod Numbers 
S - Second Level Numbering Method orf 
6 — Caption Number Style CBOLDIFigure iCbold] 
7 — Position of Caption Below box, Outside borders 
8 — Minimum Offset from Paragraph eB" 
g — Gray Shading (Z of black? Bz 


Selection: 8 


FIGURE10-3 OPTIONS MENU 


FIGURE10-4 SIDEWAYS PRINT) 
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This ic aa example of text that 
wrape on the right cide of a 
graphic. The graphic ic placed oo 
the left cide of the page, Thie tc an 
example of text that wrape oo the 
right side of a graphic. The ~ 
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text that wraps on the right ade of 
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an example of tert that wraps on the right cide of a 
graphic. The graphic ic placed oo the left cide of the 
page. This ic an erample of tert that wraps oo the right 
cide of a graphic. The graphic ic placed on the left cide 
of the page. 


FIGURE10-5 TEXT WRAPPED LEFT AND RIGHT SIDES OF GRAPHIC 


Key Sequence What it Does 
1. [(Ctrl]-[F10] Starts macro definition. 
2. defgraph Names macro. 
[Enter] 
3. Define graphics box Describes macro. 
[Enter] 
4, [Alt]-[F9] Chooses Graphics menu. 
5. 11 Selects Figure and Create options. 
6. [Ctrl]-[F10] Ends macro definition. 


Replace Step 5 with: 


2 1—For Table box. 
3 1—For Text box. 
e 4 1—For User-defined box. 


When the macro finishes execution, you are given a chance to as- 
sign further variables to the graphics box. Among your available 
choices are setting box type, vertical position, horizontal position, 
size, and wrap text feature. You may also set any of several formats 
from the Option selection. 
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Macro: Edit 


File CENTFIG. UPM 


1 - Description Centered figured box 


Z - Action 


{Graphics}11537nCEnter} 
{Graphics}146{Del to EOL} 
{Font}24Figure-1{Font}24{Enter} 


Selection: 2 


FIGURE10-6 CENTERED FIGURE BOX MACRO IN WINDOW 


If you regularly create elaborate graphics boxes, either store the 
formats in a style or include all the steps in a macro. Figure 10-6 
shows a macro, displayed in the macro editing box, that defines a 
figure box with a centered horizontal position, an italicized caption, 
a heavy border on the top and bottom, and a 20 percent shaded back- 
ground. Once the box is defined, the macro brings you back so that 
you may create or edit its contents. An example of a figure box 
created with the macro is illustrated in Figure 10-7. 


Defining Lines 


Some printers may not accept the extended graphics characters 
produced by the Line Draw feature, or the results may be less than 
acceptable. WordPerfect also provides a way to draw lines using the 
Graphics menu. In addition to assigning the length of the line, Word- 
Perfect lets you set the horizontal position, width, and shading. 
When using a Hercules monochrome graphics card, the lines do not 
show unless you are examining the document with the Print View 
command, An example of line graphics is shown in Figure 10-8. 


Desktop Publishing 243 


sie 


ae ni pr ee nats 
4 est! í as et i ARU cea wer aera uA 


mag Yeti g rra s 


NEAL baa 


=“ 


e 
+ 
A 
Ep 
p> 


ene 
ne ye pin kA ie a iy tk ape K 
A e ORCA GR 


345 a 
“ye 
Np cei rhe : 


FIGURE 10-7 EXAMPLE OF CENTERED FIGURE BOX 


FIGURE 10-8 LINE GRAPHICS IN PRINT VIEW 
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Macros can be used to draw lines of any length and position, with 
your choice of width and shading. The most basic graphic line macros 
draws a line from margin to margin using the preset options 


provided by WordPerfect. 

Horizontal Line 
Key Sequence What it Does 
1. [Ctrl]-[F10] Starts macro definition. 
2. defhline Names macro. 

[Enter] 
3. Define horizontal Defines macro 

line [Enter] 
4. [Alt]-[F9] Chooses Graphics menu. 
5.51 Selects Line and Horizontal options. 
6. [Ctrl]-[F10] Ends macro definition. 
Vertical Line 
Key Sequence What it Does 
1. (Ctrl]-[F10] Starts macro definition. 
2. defvline Names macro. 

[Enter] 
3. Define vertical line Defines macro. 

[Enter] 
4. [Alt]-[F9] Chooses Graphics menu. 
5.52 Selects Line and Vertical options. 
6. [Ctrl]-[F10] Ends macro definition. 


When the macro finishes, you may set the line variables manual- 
ly, or press 0 to accept the default settings. You need a more 
elaborate macro in order to automate the variables of the line defini- 
tion. If all the lines share the same formats, include those formats 
in the macro as shown in the example in Figure 10-9. 


Viewing the Document 


One of the more useful features of WordPerfect is the Print View 
command, where you can see a visual representation of the page as 
it will look on paper (you see only the basic text when using a dis- 
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Macro: Edit 
File BIGLINE. WPM 
1 - Description Big line macro 


2 — Action 


{DISPLAY OFF? 
{Graphics?}S1 
1 

1Z 

z2.S{Enter} 

3 


. TS{Enter?} 
4 


85~4{Enter} 
{DISPLAY ON} 


Selection: 2 


FIGURE10-9 EXAMPLE SET LINE MACRO 


play adapter that lacks graphics capability). Since you will probab- 
ly switch to Print View often, it’s worthy of a macro. 


VIEW.WPM (CHAP10 directory on Applications Disk) 


{Print) 
63 


WordPerfect remembers the magnification you last used when 
viewing your document (full, facing pages, 100%, or 200%). If you 
exit when the magnification setting is at 200%, that’s what you'll get 
when you use the Print View command again. This macro automati- 
cally switches to Full view regardless of the magnification last used. 
To exit the View screen, press [F7]. 


Font Selection 
WordPerfect has an awkward method of selecting a new font that re- 


quires you to press a series of keys, then search for the font you want 
from among a list (the more capable the printer, such as the Apple 
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LaserWriter, the longer the list). You’re likely to use only one or two 
fonts, so the rest just get in the way. Macros can be used to quickly 
select the most common fonts you use. 

When using a LaserWriter or other PostScript-compatible printer, 
you have full control over the point size of the font. The macros 
shown below also provide a way to select a point size for the font 
selected. Only a few representative macros are detailed here; com- 
pile your own macros to accommodate your needs and printer 
capability. In order to use these macros, the Laserwriter must be the 
currently installed printer. All four of these macros are included on 
the Applications Disk in the CHAP10 directory. 


PAL12.WPM—Palatino 12 Point 
(DISPLAY OFF) 
{Font)4nPalatino(Enter) 
112(Enter) 

(DISPLAY ON} 


PAL18.WPM—Palatino 18 Point 
(DISPLAY OFF) 
(Font)4nPalatino(Enter) 
118(Enter} 

(DISPLAY ON) 


SCHOOL24.WPM—New Century Schoolbook 24 Point 
(DISPLAY OFF) 
(Font)4nNew Century Schoolbook (Enter) 
124(Enter) 
(DISPLAY ON) 


HEL-B48.WPM—Helvetica Bold 48 Point 
(DISPLAY OFF) 
{Font)4nHelvetica Bold(Enter) 
148(Enter) 
(DISPLAY ON) 


Suppose you regularly use just one or two fonts, but want to be 
able to set any font size you desire. This next macro is designed to 
display all the possible choices for the LaserWriter Helvetica font 
(as shown in Figure 10-10; Helvetica is available in many different 
typefaces). You pick the desired typeface from the list, then enter a 
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Base Font 


» Courier 
Courier Bold 
Courier Bold Oblique 
Courier Oblique 
Helvetica 
Helvetica Bold 
Helvetica Bold Oblique 
Helvetica Double High 
Helvetica Narrou 
Helvetica Narrow Bold 
Helvetica Narrow Bold Oblique 
Helvetica. Nannon Obl ique 
Helvetica Oblique 
ITC Avant Garde Gothic Book 
ITC Avant Garde Gothic Book Oblique 
ITC Avant Garde Gothic Demi 
ITC Avant Garde Gothic Demi Oblique 
ITC Bookman Deni 
ITC Bookman Demi Italic 
ITC Bookman Light 
ITC Bookman Light Italic 


1 Select: N Name search: 1 


FIGURE10-10 BASE FONT LIST FOR LASERWRITER 


point size. Although the macro takes a while to write, you can copy 
it and use it as the basis to make chooser macros for other fonts. 


HELV.WPM (CHAP10 directory on Applications Disk) 


1. (CHAR) 1~Select a font:(Enter) 
1 Helvetica (Enter) 
2 Helvetica Bold(Enter) 
3 Helvetica Bold Oblique{Enter) 
4 Helvetica Double Height(Enter) 
5 Helvetica Narrow (Enter) 
6 Helvetica Narrow Bold{Enter) 
7 Helvetica Narrow Bold Oblique{Enter) 
8 Helvetica Narrow Oblique(Enter) 
9 Helvetica Oblique(Enter) 
2. {DISPLAY OFF) (DISPLAY ON) 
3. (TEXT)}O~Enter a font size. . .~ 
(DISPLAY OFF) 
4. {CASE) (VAR 1)~ 
1~Hel~ 
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2~Bold~ 
3~Bold oblique~ 
4~Double high~ 
5~Narrow~ 
6~Narrow bold~ 
7~Narrow bold oblique~ 
8~Narrow oblique~ 
9~Oblique~~ 
5. (LABEL)hel~ 
(Font}4nHelvetica (Enter) 1(VAR 0) {Enter} 
(QUIT) 
(LABEL) Bold~ 
(Font) 4nHelvetica Bold(Enter) 1(VAR 0}({Enter) 
(QUIT) 
(LABEL)Bold oblique~ 
(Font)4nHelvetica Bold Oblique({Enter) 1(VAR 0) {Enter) 
(QUIT) 
(LABEL)Double high~ 
(Font)4nHelvetica Double High(Enter) 1(VAR 0) {Enter} 
(QUIT) 
(LABEL)Narrow~ 
(Font)4n Helvetica Narrow(Enter}1{VAR 0}(Enter) 
(QUIT) 
(LABEL) Narrow bold~ 
(Font}4nHelvetica Narrow Bold{Enter} 1{VAR 0} {Enter]) 
(QUIT) 
{LABEL} Narrow bold oblique~ 
(Font)4nHelvetica Narrow Bold Oblique(Enter)1(VAR 0) {Enter} 
(QUIT) 
(LABEL)Narrow oblique~ 
(Font)4nHelvetica Narrow Oblique{Enter)}1(VAR 0) (Enter) 
(QUIT) 
{LABEL)Oblique~ 
(Font}4nHelvetica Oblique{Enter}1(VAR 0) (Enter) 
(QUIT) 
(DISPLAY ON) 


*Step 1 asks you to select a font to use. Each line ends with an 
(Enter) code so that WordPerfect displays the menu in the status 
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businessman, apparent. 


Barnhart’ 


at hand. “It 


s voice suddenly went cold, ready for the business 


doesn’t take guts to know a good business deal, 


Brant. Just good sense. And I’ve got good sense.” 


Their greetings finished, the tuo stared at each other — 


Jason Barnhart, the electronics executive; John Brant, buyer of 


electronics secrets — each one sizing up the other, measuring 


Select a font: 


Helvetica 
Helvetica 
Helvetica 
Helvetica 
Helvetica 
Helvetica 
Helvetica 
Helvetica 
Helvetica 


Bold 

Bold Oblique 
Double High 

Narrow 

Narrow Bold 

Narrow Bold Oblique 
Narrow Oblique 
Oblique 


FIGURE 10-11 MENU DISPLAY AT BOTTOM OF SCREEN 


line as well as the bottom of the screen, as shown in Figure 10- 
11. If you have a document on the screen, its text scrolls up as the 
menu appears. However, the menu text does not mix with the 
document text. Your response is stored in variable 1. 


eStep 2 turns the display off, then back on again. This wipes off the 
menu so that it doesn’t interfere visually with the document text. 


Step 3 asks you to enter a font size. Your answer is Stored in vari- 
able 0. 


eStep 4 is a (CASE) statement that matches your response to one 
of nine cases. Be sure to add the double tilde after the last 
case/label or the macro will not work. 


eStep 5 comprises the labels for the choices. The instructions in 
each label searches for the desired font from the Base Font menu, 
selects it, then enters the font size originally recorded in variable 
0. The macro then returns you to the document, where the display 
is turned back on 
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DUMMY-PAGE DESIGN MACRO 


A dummy-page design macro uses WordPerfect as a designer’s tool. 
The look of the finished page is designed in WordPerfect to make 
lines and boxes using the Line Draw feature. If your printer supports 
the IBM extended character set used by Line Draw, you can use the 
boxes and lines you create with the dummy-page design macro as 
graphics embellishments to the page. A sample dummy-page is 
shown in Figure 10-12. 

The DPBOXER.WPM macro, detailed below, automatically selects 
the Line Draw menu. You then position the cursor to where you want 
the box or line. Pressing the [Enter] key starts the box or line. A 
line/character counter appears in the upper left corner of the screen 
once you press the cursor keys. The first digit displays the charac- 
ter position and the second digit displays the line position. The num- 
bers are relative to where you started the graphic. Press the right 
arrow key to enlarge the box horizontally, and the down arrow key 
to enlarge the box vertically. The counter display shows the width 
and the length of the box. Do NOT move the cursor above or to the 


FIGURE 10-12 SAMPLE DUMMY PAGE 


If: 


Z jl: 3 *; 4 Change: S Erase: 6 Move: 6 Ln Z4 Pos 8.1Z 


Desktop Publishing 251 


left of the original starting point. When you are finished defining the 
dimensions of the box, press [Enter] again and the box will appear. 


°When drawing boxes, first position the cursor at the upper left 
corner, where the box is to begin. This defines a start point. Both 
the line and character position numbers in the counter display 
should show some value over 0. 


°When drawing lines, first position the cursor at the top or left side 
of where the line is to begin. This defines a start point. Either the 
line or character position number in the counter display should 
show 0. 


DPBOXER.WPM (CHAP10 directory on Applications Disk) 


1. {ASSIGN) 1~0~ 
{ASSIGN}2~0~ 
2. {DISPLAY OFF) 
{(Exit}nn 
(Format) 170({(Enter}0(Enter} (Enter) 
250(Enter)0(Enter) (Enter) (Enter) 
(Screen}26 
(DISPLAY ON) (Right) (Left) 
3. (LABEL)start~ 
(ASSIGN) 0~~ 
(LABEL) loop1~ 
(VAR 0) 
(LOOK) 0~ 
(IF}" (VAR 0}"="(Enter)}"~(GO)make box~ 
{ELSE) (GO)loop1~ 
(END IF) 
4. {LABEL)make box~ 
(ASSIGN)0~~ 
{LABEL} loop~ 
(VAR 0) 
{LOOK)0~ 
(IF)" (VAR 0)"="(Enter)"~ 
1(Esc) (VAR 1) (Left) 
(Esc) (VAR 2)}(Up} (Esc) (VAR 1} (Right) 
(Esc) (VAR 2) (Down) 
(ASSIGN) 1~0~ 
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(ASSIGN)}2~0~ 
6(GO}start~ 
(ELSE) 
(IF)"(VAR 0)"="(Right)}~ 
(ASSIGN) 1~(VAR 1)+1~(CALL}display~(GO}loop~ 
(ELSE) 
(IF)"(VAR 0}"="(Left}"~ 
(ASSIGN) 1~(VAR 1)-1~(CALL)display~(GO)loop~ 
(ELSE) 
MF)" (VAR 0)"="{Up}"~ 
(ASSIGN) 1~(VAR 2)-1~(CALL)display~(GO)loop~ 
(ELSE) 
{TF}" (VAR 0)"="(Down)~ 
(ASSIGN)1~(VAR 2}+1~(CALL)display~{GO)loop~ 
(ELSE) (GO)loop~ 
(END IF) (END IF){END IF)(END IF) (END IF) 
5. (LABEL)display~ (PROMPT}{Home}{Del to EOL) (VAR 1).. 
(VAR 2)~ 
(RETURN) 


¢Step 1 assigns zeros to variables 1 and 2, used for the number 
counter display. 


*Step 2 clears the document (make sure you don’t have anything 
you want to keep in the current document), sets formatting to zero 
margins and chooses the Line Draw menu. 


¢Step 3 waits for you to press the [Enter] key, which signals that 
you have selected a start point for a line or box. 


*Step 4 is the "make box" routine that counts the number of times 
you press the cursor keys and assigns the result to variables 1 and 
2. When you press [Enter], it signals that you have finished defin- 
ing the box or line. Upon pressing [Enter], the macro selects the 
1 option in the Line Draw menu and draws a graphic, depending 
on the values stored in variables 1 and 2. After that, the variables 
are cleared, the macro selects the 6 (move) option, and goes back 
to the "start" routine (to draw another box). 


*Step 5 is the "display" subroutine. It places the cursor counter in 
the upper left portion of the screen. The counter helps you gauge 
the size of the line or box you are drawing. 


Desktop Publishing 253 


When you are done drawing, press [F1] twice. 

If you move the cursor above or to the left of the start point while 
defining a line or box, one or both of the counters will display a large 
65,000+ number. This occurs because WordPerfect’s variables can’t 
contain negative numbers. (Refer to Chapter 4, "Macro Program- 
ming, as well as Chapter 16, "Macro Strategies," for more informa- 
tion on this topic.) You should avoid this or WordPerfect will attempt 
to make a very big line or box. 

Also note that the counter display may temporarily disappear 
while defining a box. This happens when WordPerfect rewrites the 
display, as it does when scrolling down past the bottom of the screen. 
The counter will reappear if you press the [Up] key. 

The macro is designed to create a page layout from scratch. You 
can use DPBOXER.WPM to draw lines and boxes around already 
written text by removing the "(Exit}nn" and format instructions that 
appear near the beginning of the macro. 

An additional macro, BOXER.WPM (placed in the CHAP10 direc- 
tory on the Applications Disk), is functionally similar to 
DPBOXER.WPM, but it doesn’t Reset the tabs margins, or erase the 
existing document. It automatically terminates after the box is 
drawn. 


CHAPTER 11 
INVOICES, 


STATEMENTS, AND 
RECEIPTS 


O T invoices, statements, and receipts look like 
they mean business. But if you don’t have a dedicated accounting 
program (and a computer to run it) in your office, producing 
electronic invoices, statements, and receipts can be a time-consum- 
ing task. If your accounting needs are moderate, you can enlist the 
help of WordPerfect to produce the paperwork you need. The added 
advantage of WordPerfect-generated accounts is that you don’t need 
to leave your regular work to make out a receipt. Call up a macro, 
enter the information, and print the result. 

You'll find instructions on producing a number of different in- 
voices, statements, and receipts in this chapter. All use macros and 
a few borrow functions from WordPerfect’s merge feature. You will 
see how the following documents are produced: 
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¢Letter-style invoice. 
eAuto-calculated invoice or statement. 
e Point of sale receipt. 


eAuto-calculated expense report. 


LETTER-STYLE INVOICE 


If you are a professional, offering your services to others, you can 
bill your time and expenses using the customary letter-style invoice. 
It’s relatively easy to create, even easier if you do it on WordPerfect 
using macros. 

Here are two versions of the same letter-style invoice. One version 
uses a main macro and three sub-macros, and the other ac- 
complishes the same results in a single macro. Both use the same 
invoice template, named INV.TXT, shown in Figure 11-1. The 
template includes the basic formatting for the page, the return ad- 
dress, data code, and [Math On] code. Specifically, the page format- 
ting for the invoice template is: 


¢Center page. 
‘Tab set at 0", .5", 1.5", and 6.5". 


These formats assume standard WordPerfect defaults, including 
single spacing and no page numbering. If you have set initial for- 
mats either using the Setup or Format commands, be sure to cancel 
them with the appropriate code or they could upset the appearance 
of the invoice. The [Math On] code should be at the very end of the 
document 


Nested Macro Invoice 


The nested invoice system uses four macros: a main macro, called 
INVOICE.WPM, and three sub-macros. The function of each macro 
is fairly well defined, and because they are separate, you can easily 
see how they interact. Although you will probably want to build your 
letter invoice system based on the single macro shown below, the ap- 
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<Your Name Here> 

<Your Address Here> 
<Your City, State, ZIP> 
<Your Phone Number> 


January 1, 1968 


Dt\WPSB\TEXTNINY, TAT Doc 1 Pg 1 Ln 1 Pos 18 
Oe te he Oe oS ee S a : } 


€ è ae F, N EAA T G A —.- ah a. 
[Center PIJET Set:0 ,8.5 ,1.5 ,6.S JCBOLDIJ<Your Name Here?CHRt] 
«Your Address Here>CHRt 

“Your City, State, ZIP CHRtI 

<Your Phone Number>CHRt) 

CholdJCHRtI 

CDate:3 1, 4] 0HRt] 

CHRtI 

CHRtI 

CMath Onl 


Press Reveal Codes to restore screen 


FIGURE 11-1 TEMPLATE DOCUMENT FOR LETTER-STYLE INVOICE 


proach outlined here is a good example of how WordPerfect nests and 
chains to other macros. 

The main INVOICE.WPM macro calls up the invoice template, 
INV.TXT. It then pushes the cursor all the way to the end of the docu- 
ment and past any formatting codes (namely the [Math On] code). 
You are then prompted to type the name and address of the recipient 
of the invoice. Pressing [Enter] moves you down one line; press 
[Ctrl]-[Enter] when you are finished entering the name and ad- 
dress. 

When the macro senses you have pressed [Ctrl]-[Enter], it 
branches (nests) to macro INVA.WPM. Before it leaves for the nested 
macro, however, WordPerfect is instructed that if it receives a Can- 
cel, it should chain off to macro INVB.WPM. 

The INVA.WPM fills in a portion of boilerplate text into the in- 
voice, then waits for you to enter each item, At the indent, shown in 
Figure 11—2, you type the description of the service or expense. When 
you are done, press [Enter], and the macro steps you to the next tab 
stop, where you enter the amount. Pressing the [Enter] key moves 
you down one line for the next item. Repeat the process as needed. 
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When you are done, write "TOTAL" on the last line, press [Enter], 
then type a + sign in the amount column. Finally, press [F1] to quit. 
Because you are in a nested macro, WordPerfect first brings you back 
to the main INVOICE.WPM macro. If you wanted to cancel all macro 
action, you'd press [F1] again. In this case, however, the nested 
INVA.WPM macro reports a Cancel condition back to IN- 
VOICE.WPM. The main macro already knows what to do when it 
receives a Cancel, so it chains off to INVB.WPM. 

The purpose of the INVA.WPM macro is to calculate the totals in 
the amount column, then turn off the math function. The final in- 
struction is to chain to INVC.WPM, which ends the invoice with a 
signature line, name, and social security number. Although 
INVB.WPM and INVC.WPM are shown here separately to 
demonstrate macro chaining, you could easily combine them into one 


macro. The following macros are contained in the CHAP11 directory 
on the Applications disk. 


INVOICE.WPM 
(Retrieve) INV.TXT{Enter) 
(Home) (Home) (Home}({Down}) 
(PROMPT)Type the name and address here; press Ctrl-Enter 


FIGURE 11-2 FILLING INVOICE AT INDENT 


(Your Name Here> 
“Your Address Here> 
‘Your City, State, ZIP> 
<Your Phone Number? 
January 1, 1980 
Anderson Gear Company 


PO Box 15678 
Pikeville, SC 29887 


INVOICE 
For Professional Services Rendered 


Press Kit for Gear Convention 


Doc 1 Pg 1 Ln 19 Pos 15 
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when done. -~ 
{ASSIGN} 2~~ 
(LABEL)loop~ 

(VAR 2) 

(LOOK) 2~ 

(IF}"(VAR 2)"="(HPg)"~ 
(ELSE) (GO)loop~ 
{END IF) 

{ON CANCEL) (CALL)cancel~~ 
(NEST)inva~ 
{LABEL})cancel~ 
(CHAIN)invb~ 
(RETURN) 


INVA.WPM 

{Bold} (Center)I.N.V.O.1I.C.E({Bold} (Enter) (Enter) 
For Professional Services Rendered:({Enter) (Enter) 
(LABEL) line~ | 

(Indent) (PAUSE) (Tab} (PAUSE) (Enter) 

(GO) line~ 


INVB.WPM 

(Enter) (Math/Columns)2 
{Math/Columns}1 
(CHAIN}inve~ 


INVC.WPM 
{Enter} (Enter) (Enter) 
(Enter) 
(your name here){Enter) 
(your social security number here)(Enter} 


A sample completed invoice is shown in Figure 11-3. Total time 


for entry was approximately 15 seconds, and because WordPerfect 
does the math for you, you are assured of excellent accuracy. 


Single-Macro Invoice 


The single-macro invoice does the same job as INVOICE.WPM, 
but because it takes up only one macro file, it’s easier to store on 
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<Your Name Here> 

<Your Address Here> 
<Your City, State, ZIP> 
<Your Phone Number> 


June 30, 1988 
Roger Sounds Systems 


19834 Orangegrove Blvd. 
Madison, WI 53704 


INVOICE 


For Professional Services Rendered: 


Design services for new Calif store. $12,000 
Expenses (see enclosed_ 4,987 
TOTAL 16,987.00 


<Your Name Here> 
SSN: ##9-#€-8482 


FIGURE 11-38 SAMPLE COMPLETED INVOICE 
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disk. This version of the invoice generator also includes a semi- 
automatic total tally. A (CHAR) message near the end of the macro 
prompts you to press the + key when you are finished or the [Enter] 
key to go on. When you press the + key, the macro automatically adds 
a "TOTAL" in the last line and an = sign in the amounts column. The 
invoice is then calculated for you. 


NEWINV.WPM (CHAP11 on the Applications Disk) 
(Retrieve) INV.TXT (Enter) 
(Home) (Home) (Home})(Down) 
(ASSIGN) 2~~ 
{LABEL} loop~ 
(VAR 2) 
(LOOK)2~ 
(IF)"(VAR 2}"="(HPg)"~ 
(ELSE)}(GO)loop~ 
(END IF) 
{Enter} {Enter} 
(Bold) (Center}I.N.V.O.I.C.E(Bold) (Enter) (Enter) 
For Professional Services Rendered:(Enter) (Enter) 
(ASSIGN) 3~~ 
{LABEL)loop1~ 
(IF)"(VAR 3}"="+"~ 
{ELSE)(GO)line~ 
{END IF) 
{Indent) TOTAL (Lab}+({Enter) 
(Math Columns)2 
{Math Columns}1 
{Enter} (Enter} (Enter) (Enter) 
(Enter) 
(your name here) (Enter) 
(your social security number here)(Enter) 
(QUIT) 
(LABEL)})line~ 
(Indent) (PAUSE) {Tab} (PAUSE) (BELL) 
(CHAR)3~Press + if finished or Enter to go on. - -~(Enter} 
{GO)loop1~ 


You use this macro much the same as the last one. When the macro 
is started, it automatically retrieves the INV.TXT invoice template. 
The macro then pauses to allow you to enter the name and address 
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of the recipient of the invoice. Pressing [Ctrl]-[Enter] signals the 
macro go on. It then builds the invoice a little more, stopping to allow 
you to enter the description and amount of each invoice item. Press 
[Enter] after entering a description and amount; don’t press [Tab] 
to express to the amount column after entering a description. 

When you are finished entering items, press + as instructed by the 
macro. This signals that your entry is complete; the macro calculates 
the amounts, places the result beside TOTAL in the amount column, 
then finishes the invoice. It is now ready for you to print. 

Note that pressing [Ctrl]-[Enter] in WordPerfect normally in- 
serts a hard page into the document. In this case it doesn’t. Why? 
The IF. ..ELSE structure, as written here, passes all keystrokes ex- 
cept the one it is looking for. In this case, the instruction looks for 
(HPg), the code for [Ctrl]-[Enter]. As long as you don’t press [Ctrl]- 
[Enter], the macro repeats the loop in which it scans the keyboard 
and prints out the characters you type. 

The moment you press [Ctrl]-[Enter], the loop stops, and because 
the loop doesn’t go back to the beginning, the {HPg] code isn’t entered 
into the document. In other words, the hard page code is effectively 
"trapped" by the macro. If the (VAR 2) were missing from the loop, 
no characters would print out at all. 


AUTO-CALCULATED INVOICE AND STATEMENT 


Perhaps your invoice is a little more complicated, or you are in the 
business of selling goods and not professional services. In that case, 
you need a more conventional invoice format, such as the one shown 
in Figure 11-4. This invoice was created entirely in WordPerfect 
without any intervention by the user other than entering the raw 
data. WordPerfect calculated all of the results and filled in all the 
blanks. | 

The invoice macro seems fairly complex, but when broken down 
into its various routines it’s really quite simple. You don’t need to 
know exactly how the invoice macro works to use it, but you'll need 
to acquaint yourself with its structure should you want to rewrite it 
to suit your individual requirements. 

The invoice macro uses an invoice template. This template is a 
primary merge document and includes merge fields for the informa- 
tion you enter during macro execution. It also contains a company 
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<Your Company Name Here> 
<Address> 
<City, ST, ZIP> 
<Phone #.> 


Invoice Number: A0987-2 
Customer Number: 9485765 
Date: 4/2/1989 


Sold To: Bill To: 
Stratford Computer Associates Same 
PO Box 30 


Stratford, CT 06497 


ATTN: Roger 


Your Order # 


None 

Item Qty 

1 40 

2 100 

3 15 

4 2 
FIGURE 11-4 


Waters 


Shipped Via Date Shipped Terms 


UPS 4/2/1989 Net 30 
Description Unit Price Amount 
5 1/4-inch Disks wad 9.20 
Boxes small labels 1.29 129.00 
2600-ct clean perf paper 8.97 134.595 
Atari-type joysticks 4.97 9.94 

Subtotal 282.69 
Sales Tax 18.37 
Total Due 301.06 


TRANK YOU FOR YOUR ORDER 


CONVENTIONAL INVOICE FORMAT 
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Invoice Number! ^F1^ 
Customer Number! ^F2^ 
Date: “D 


Sold To: Bill To: 
“F3* “Fq* 


A Ne MRG — 1 O Pos 18 


a Numbering:No page numbering]CHeader A?1; CCntr3C BOLDI< ‘Your Company Name Hera? 
CC/A/FlrtI]CHRtI 


C[CntricAd ... JEUN 

CCenter PgiCHeader Ar @BI]CHRtI 
Invoice Number: “F1*CHRtI 
Customer Number! “F2*CHRt) 
Date: “DCHRtI 

CHRtI 

CHRtI 


[Col Def:2,1",4",4.5",7.S°J£Col OnJSold Tot CHRtI 


Press Reveal Codes to restore screen 


FIGURE 11-5 FORMAT, SCREEN 1 


FIGURE 11-6a FORMAT, SCREEN 2 


Invoice Number: “F1* 
Customer Number: “FZ~ 
Date! ^D 


Sold To: Bill To: 
RER ~Fq* 


D: \UPSONTEXTN INUPRI. MRG Col Z Doc 1 Pg 1 Ln B Pos 45 


FI 'CHRE) 
CHPg] 

111 To: CHRtJ 

F4“CHRt) 
(Col Off3 
CHRtI 
(Tab Setre",@.5°.1",2.7°,4.1",5.7°]Your Order zCTablShippad VialTabIDate Shippe: 
CTabJ TerssfHRt) 


“F2F-C Tab *FZA*( TabI*FZ25*£ Tab]*F26* CHRtI 
CHRI 


Press Reveal Codes to restore screen 
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Sold To: Bill To: 
“AF3* “F4* 


Your Order 2 Shipped Uia Date Shipped Terms 
“F24* ^F25^ ^F26^ 


Qty Description Unit Price Amount 


Doc 1 Pg 1 Ln 16 Pos 18 


py LAE aR a m 
. es, . DALS . a : 
oe PA a ae , 


be re Scr Tay i . i ` 
Che IN ECER COSCON O 


[Tab Set:8”,8.5°”,1”,1.8°,2.5",5.7°,6.9”JItemCTab]QtyCTab]DescriptionCTab]Unit Pr 
icelTabJAmountCHRt] 

CDecml“Algn Char:.,,]€Math DefICMath Oni AGG] 

“FS“CHRtI 

“F6*CHRtI 

“F?"CHRtI 

“FB“CHRtI 

“FS*CHRtI 

“FiB*CHRtI 


Press Reveal Codes to restore screen 


FIGURE 11-6b FORMAT, SCREEN 2 


FIGURE 11-7 FORMAT, SCREEN 3 


Item Qty Description Unit Price Amount 


^F6^ 

^F7^ 

“F19~ 

“F11* 

“F12* 

“F13* 

Hath Doc 1 Pg 1 Ln 25 Pos 10 


F11°CHRtI 
“F12“CHRt] 
M13 CHRE] 

F14“CHRt) 
“F1S*CHRtI 
“F16*CHRtI 
“F1I?7“CHRtI 
“FIS“CHRtI 
“F1S“CHRtI 
“F2Z@*CHRtI 


Press Reveal Codes to restore screen 
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name and address in a header and special math definitions and for- 
matting. The formats for the invoice template, named INVPRI.MRG, 
are shown in Figures 11—5 through 11-7. Note that the template 
uses several different math definitions and that the format of the 
Subtotal, Sales Tax, and Total Due lines is very specific. You will 
find it easier to use the already completed INVPRI.MRG document 
included on the Applications Disk. 

The invoice macro is really composed of three macros: one main 
macro named INVMAC.WPM and two smaller auxiliary macros 
named MRGR.WPM and ADDTAB.WPM. 


INVMAC.WPM (CHAP11 directory on the Applications Disk) 
1. (Date/Outline}32/1/4{Exit)0 
(ASSIGN) 4~1~ 
2. {PROMPT)Enter invoice number. - -~ 
(CALL)enter~ 
{(PROMPT)Enter customer number. - -~ 
(CALL)enter~ 
3. {(PROMPT)Enter Sold to: press Ctrl-C when finished. - -~ 
(CALL) waitc~ 
{PROMPT) Enter Bill to: press Ctrl-C when finished. - ~ 
(CALL) waitc~ 
4. (LABEL)items~ 
(VAR 4) (Tab) 
(PROMPT) (4R)Enter item #(VAR 4); press Enter when finished 
_ + {AS)~ 
(CALL)enter~ 
{GO)anymore~ 
5. (LABEL) rest~ 
(ASSIGN) 0~1~ 
(PROMPT)}Enter customer order number. : -~ 
(CALL)enter~ 
(ASSIGN)0~2~ 
(PROMPT) Enter shipper or press the Esc key to enter UPS. - -~ 
(CALL)enter~ 
(ASSIGN) 0~3~ 
(PROMPT]Enter date shipped or press the Esc key if today. - -~ 
(CALL)enter~ 
(ASSIGN) 0~4~ 


(PROMPT)}Enter terms of press the Esc key if Net 30. - -~ 
(CALL)enter~ 
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(^E) 
(GO)merge~ 
6. (LABEL) waitc~ 
(ASSIGN) 2~~ 
(LABEL) goback~ 
(VAR 2) 
(LOOK)2~ 
(IF }" (VAR 2)}"="(4C}"~(GO}done~ 
{ELSE} (GO)goback~ 
{END IF} 
7. (LABEL)done~ 
(AR) (Enter) 
(RETURN) 
8. (LABEL)enter~ 
{ASSIGN} 2~~ 
{LABEL} loop~ 
(VAR 2) 
(LOOK) 2~ 
(IF)"(VAR 2)}"=(Esc}"~(CALL)Esc+(VAR 0)~(RETURN} 
(ELSE) 
{(IF)}"VAR 2)"="(Enter)"~(4R) (Enter) (RETURN) 
{ELSE} 
(END IF)(END IF) 
(GO) loop~ 
(RETURN) 
9. (LABEL)Esc+1~ 
(^R) (Enter) 
(RETURN) 
(LABEL) Esc+2~ 
UPS (4R) (Enter) 
(RETURN) 
(LABEL) Esc+3~ 
(Date/Outline}1(4R) (Enter) 
(RETURN) 
(LABEL) Esc+4~ 
Net 30(^R) {Enter} 
(RETURN) 
10. {LABEL)anymore~ 
(CHAR)3~Are there any more items?.(y/n) -~ 
(IF)"(VAR 3)"="y"~(ASSIGN)4~(VAR 4)+1~(GO}items~ 
(ELSE) 
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(IF)"(VAR 3)"="Y"~(ASSIGN)4~(VAR 4)+1~(GO}items~ 


(ELSE) 
(IF)" (VAR 3)"="n"~(GO)finished~ 
(ELSE) 
(IF)"(VAR 3)"="N"~(GO)finished~ 
(ELSE) 


(END IF)(END IF}(END IF)(END IF) 
(PROMPT)Press y or n. - -~{BELL) (WAIT) 15~(GO)anymore~ 
11, (LABEL)finished~ 

(ASSIGN}5~18-(VAR 4)}~ 

(Esc) (VAR 5) (NEST) mrgr~ 

(GO)rest~ 

12. (LABEL) merge~ 

(Save) INVSEC.MRG(Enter} 

(IF) (STATE) &1024~y({GO)}startmrg~ 
(ELSE)(GO)startmrg~ 

(END IF) 

13. (LABEL)startmrg~ 

(Exit}nn 

(Merge/Sort)1 

INVPRI.MRG(Enter) 

INVSEC.MRG(Enter} 

14. (Home){Home}) {Up} 
(Search})Amount(Search) 

(Esc) (VAR 4) (NEST)addtab~ 

15. (Search)Subtotal{Search} 
(Math/Columns)2 

{Block} (Word Right) (Word Right) (Left) (Left) 
(Move) 12{(Right) (Right) (Enter) 
{Math/Columns)2 

16. (Word Right) (Block) (Word Right) (Del)y 
(Indent) (Indent) 

(Down) 

(Home) (Home}{Up) 


MRGR.WPM (CHAPII directory on Applications Disk) 
(Merge R) 


ADDTAB.WPM (CHAP1I directory on Applications Disk) 
(Right) (Right) (End) (Tab) 
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eUsing a new, blank document, Step 1 sets a date format of 
#H#/##/H###, Variable 4 is filled with a value of 1. 


°In Step 2, the macro first prompts you to enter an invoice num- 
ber. After the prompt, the macro calls the "enter" subroutine, 
which essentially waits for the [Enter] key to be pressed before 
continuing. The macro repeats the process with a customer num- 
ber. 


oStep 3 asks for the Sold to: information. Since you must be able 
to enter a name and address on separate lines, the [Enter] key is 
used as usual and the entry is complete when you press [Ctrl]-C. 
After the prompt, the macro goes to the "waitc" subroutine, which 
waits for you to press [Ctrl]-C. The process repeats for the Bill 
to: information. 


oStep 4 comprises the actual items of the invoice. Although not 
stated in the prompt, first enter the quantity, press [Tab], enter 
the description, press [Tab] once again, then type in the unit cost. 
Finish by pressing the [Enter] key. 


°Step 5 first asks you to enter the customer order number. It then 
prompts you for shipping information. You can either enter the 
shipper or press the [Esc] key to enter UPS (or whatever shipper 
you use most). While waiting for your reply, the macro jumps to 
the "enter" subroutine. If you press the [Enter] key, WordPerfect 
goes back to the point it left before branching off to the subroutine 
and continues on. But if you press the [Esc] key, another sub- 
routine is called. The exact subroutine depends on the value in 
variable 0. If it is a 2, for example, the macro branches to the 
"Esc+2" subroutine. Other information asked by the macro are the 
date shipped, and terms. These, too, have [Esc] entry shortcuts. 
At the end of Step 5, the macro enters a “E merge code and jumps 
to the "merge" routine. 


eStep 6 is the "waitc" subroutine. As long as you don’t press [Ctr]l]- 
C, the macro passes your keystrokes to the document. When you 
press [Ctrl]-C, WordPerfect ends the entry with a “R merge and 
[HRt] code. 


eStep 7 is the "done" routine, which places a ^R merge code and 
[HRt] code in the document. 


*Step 8 is the "enter" routine, which checks to see if you have 
pressed the [Enter] or [Esc] keys. 
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Step 9 comprises the "Esc+#" subroutines. 


¢Step 10 asks if there are any more items to enter into the invoice. 
If you press y (or Y), the macro increases the value in variable 4 
by 1, then jumps back to the "items" routine. If you press n (or N), 
the macro jumps to the "finished" routine. 


The "finished" routine in Step 11 counts the number of items you 
have entered (monitored by the value in variable 4), and subtracts 
it by 18 (one less than the number of blanks lines you have for the 
items in the invoice). Unused lines are filled with empty ^R codes. 

*Step 12 saves the merge document as INVSEC.MRG. The macro 
checks to see if the file already exists. If it does, it answers "y" to 
the yes/no prompt that appears; if the file doesn’t exist, the macro 
saves it as usual. 


¢Step 13 actually performs the merge between the just-saved IN- 
VSEC.MRG document and the INVPRI.MRG template document. 


¢Step 14 searches for the text "Amount," then nests to the AD- 
DTAB.WPM macro. This macro formats the merged document so 
that it tabs out to the right-most calculated entry column. This is 
necessary because WordPerfect won’t add the "!" calculate symbol 
in a column unless you have spaced or tabbed over to it. 


¢Step 15 searches for the text "Subtotal." The macro calculates the 
formulas and copies the number in the Subtotal row. It then pas- 
tes the number into the A column of the Sales Tax row. The for- 
mula written in the math definition at the beginning of this row 
says to multiply the number in column A by 0.065, or 6.5 percent, 
a common sales tax amount (you can easily change the formula as 
necessary). Upon recalculation, the actual sales tax amount is 
entered by WordPerfect. The Total Due reflects the Subtotal and 
Sales Tax amounts added together. 


eIn Step 16 the macro deletes the number placed in column A of 
the Sales Tax row and places two [Indent] codes to align the tax 
figure properly with the others. Finally, the macro brings the cur- 
sor back to the beginning of the invoice, where you can review it 
and print it out. 


The INVMAC.WPM macro goes through some contortions at the 
end to accomplish its task, but in view of the way WordPerfect works, 
these added steps are necessary. The program lacks an extensive 
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math calculation feature when working in columns (the math fea- 
ture is fairly extensive if you are calculating numbers by rows). This 
is why the subtotal is copied and pasted in order to calculate the 
sales tax. 

Unfortunately, you can’t use WordPerfect variables to calculate 
invoices, because they can be used with whole numbers only. Trying 
to multiply 10.54 by .065 yields "10.54*.065," not 11.26. WordPerfect 
variables treat fractional numbers as text. 


POINT-OF-SALE RECEIPT 


The last thing you want your customers to do is wait in line while 
you fiddle with a computer to produce a receipt for them. It’s an- 
tiproductive for you too, because you could be spending the time help- 
ing others and turning a greater profit. This point-of-sale receipt 
system uses preprinted or blank forms and a macro engine to speed 
up the process. The system is based on WordPerfect’s Advance fea- 
ture which allows you to specify an exact position on the page for 
text. Advance is most often used as a forms fill-in device, because it 
allows you to use preprinted forms and still get the information in 
the right blanks. 

There are many ways to implement forms fill-in—including using 
document comments for instructions—but the macro technique 
shown here is the most foolproof. It can be readily modified to work 
with any form, for any application. The macro presented below also 
contains routines that calculate the amounts and enter a total. A 
completed, printed form is shown in Figure 11-8 


FILLIN.WPM (CHAPI1 directory on Applications Disk) 
1. {DISPLAY OFF) 
{LABEL)setup~ 
{Setup)81U{Enter) (Enter) 
{Format) 175{Enter)5{Enter) (Enter) 
250{Enter)0(Enter) (Enter}{Enter) 
{Switch} (Exit)nn 
{(Math/Columns)2(Right) (Right) (Right}0A*B(Enter)} 
(Exit}1 
(Switch) 
2. (TEXT) 1~Enter the order number. - -~ 
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Sod To: 


Anytown, USA 12345 


Order No: —AIOOL — S o 
Dote_____ 6/7/89 > 
Solespeson_Michael Geo ___—__ —_—_—_——_ _ — 
Shipping Address: 


er SU d ee nee ee 


Telephonehoa-1212 ShipVia: UPS Cat: 


(oN) 
» 
g 


- 
O 
I 
e 
e 
Ht 
CJ) 


TERS: $ Cosh 
D coo 
G On Account 


O Charge. 
MONIA Oar 


FIGURE 11-8 FILLED IN FORM 


Sub Toto! —244. RR 


15.92 

Sates Tax ————— 
260.80 

TOAL —_-——_—— 


Defvery Charge ————___—_ 


Bolonce Due ——— 
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(Format}41545{Enter} 

131{Enter) {Enter) (Enter) 

(VAR 1)(Enter} 

(TEXT) 1~Enter today’s date. - -~ 
(Format)41545(Enter) 

133(Enter) (Enter) (Enter) 

(VAR 1)(Enter) 

(TEXT) 1~Enter the salesperson. - -~ 
(Format)41545(Enter) 

135(Enter) (Enter) (Enter) 

(VAR1)} (Enter) 

(TEXT) 1~Enter sold to name. ~ 
(Format)4151{Enter) 

139(Enter) {Enter} (Enter) 

(VAR 1}(Enter} 

(TEXT) 1~Enter sold to address. - -~ 
{(Format}4151(Enter) 

1311{Enter) (Enter) (Enter) 

(VAR 1)(Enter) 

(TEXT) 1~Enter sold to city, state, and ZIP. - -~ 
(Format}4151{Enter) 

1313(Enter) (Enter) (Enter) 

(VAR 1)(Enter) 

(TEXT) 1~Enter bill to name. - -~ 
(Format}41545(Enter) 

139(Enter) (Enter) (Enter) 

(VAR 1}(Enter} 

(TEXT) 1~Enter bill to address. - -~ 
(Format)41545(Enter) 
1311{Enter} (Enter) (Enter) 

(VAR 1}(Enter) 

(TEXT)}~Enter Bill to City, State, ZIP.~ 
{(Format)41545(Enter) 

1313 (Enter}{Enter) (Enter) 

(VAR1) (Enter) 

(TEXT}1~Enter telephone number. - -~ 
(Format)4155(Enter) 

1315{Enter) (Enter) (Enter) 

(VAR 1){Enter) 

(TEXT) 1~Enter shipped via. : -~ 
(Format)41520(Enter) 
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1315{Enter) (Enter) (Enter) 
(VAR 1}(Enter) 
(TEXT) 1~Enter date shipped. - -~ 
(Format)41565 (Enter) 
1315(Enter)}{Enter) (Enter) 
(VAR 1)(Enter) 
3. (ASSIGN) 0~1~ 
(ASSIGN) 7~1~ 
4, (LABEL)items~ 
(ASSIGN]8~(VAR 7)+19~ 
(TEXT}2~Enter the QUANTITY of item (VAR 0}. -~ 
(Format)4155{Enter} 
13(VAR1) (Enter) (Enter) (Enter) 
(VAR 2} (Enter) 
(TEXT}1~Enter the DESCRIPTION of item (VAR 0). - -~ 
(Format)41510(Enter] 
13(VAR 8} (Enter) (Enter} (Enter) 
(VAR 1) (Enter) 
(TEXT)3~Enter the UNIT PRICE of item (VAR 0). - -~ 
(Format)41555(Enter) 
13(VAR 8) {Enter} (Enter) (Enter) 
(Tab Align) (VAR 3} (Enter) 
5. (CALL)computeamt~ 
6. (Iformat)41565(Enter) 
13(VAR 8}{Enter) (Enter) {Enter} 
(Move41 {Tab Align) (End) (Enter) 
7. (CHAR)}1~Do another’? (y/n). -~ 
(IF)"(VAR 1)"="y"~ 
(ASSIGN)7~(VAR 7}+2~ 
(ASSIGN}0~(VAR 0}+1~ 
(GO)}items~ 
(ELSE) (GO)terms~ 
(END IF} 
8. (LABEL)terms~ 


(CHAR) 1~Terms: 1 Cash; 2 COD; 3 On Account; 4 Charge. - -~ 

(IF)(VAR 1)=1~(Format)4153 (Enter) 1351 (Enter) {Enter) 

(Enter) X 

(ELSE) 

(IF) (VAR 1)=2~(Format)4153(Enter) 1358 (Enter) (Enter) 
(Enter) xX 

(ELSE) 


10. 


11. 


12. 
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(IF) (VAR 1)=3~{Format)4153 (Enter) 1355 (Enter) (Enter} 
{Enter} X 

(ELSE) 

(IF)(VAR 1j=4~(Format)4153(Enter) 1357 (Enter) (Enter) 
(Enter) X 

(ELSE) 

(END IF) (END IF) (END IF)(END IF) 


. (LABEL)})subtotal~ 


(Switch) 

(End) (Enter) 

(Tab) (Tab) (Tab) (Tab)+ 

(Math Columns}2 

(Left} (Left) (Block) (Word Left) (Move) 12(Cancel) 
(Switch) 

(Format})41565(Enter) 

1351(Enter) (Enter) (Enter) 

{(Move)41(Tab Align) (End) (Enter) 

(LABEL) salestax~ 

(Switch) (Exit}nn 

(Math Columns)2{Right) (Right)0 
A*.065(Enter) (Exit)1 

(Tab) (Move) 41(End) {Tab) (Tab) 

(Math Columns)2 

(Block) (End) (Left) (Move) 12(Cancel) (Switch) 
(Format})41565(Enter} 

1353 (Enter) (Enter) (Enter) 

(Move)41(Tab Align) (End}{Enter) 

(LABEL) total~ 

(Block) (Up) (Up) (Move}12(Cancel) (Home) (Home) (Down) 
(Switch) (Exit}nn 

{Math/Columns}1 

(Move)41(Home} (Home) {Down) (Enter) (Tab}+ 
(Math/Columns)}2 

(Left) (Block) (Word Left) (Move) 12(Cancel} (Switch) 
(Format}41565(Enter) 

1355 (Enter) (Enter) (Enter) 

(Move)41 (Tab Align) (End) (Enter) 
{LABEL})reset~. 

{Switch) (Exit}nn (Switch) 

(DISPLAY ON} 

(QUIT) 
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13. (LABEL)computeamt~ 
(Switch) 
(End) {Enter) 
(Tab) (VAR 2) (Tab) (VAR 3) (Tab) {Tab} 
(Math/Columns}2 
(Block) (End) {Left} (Move) 12{Cancel) 
(Switch) 
(RETURN} 


¢Step 1 sets the stage of the receipt by turning the display off and 
setting these formats: 


¢Change default unit of measurement display to lines/columns. 
¢Change top/bottom margins to 0.5". 
°Change right/left margin to 0". 


eSwitch to Doc 2, clear it, then set up a math definition that mul- 
tiplies to numbers. Switch back to Doc 1. 


¢Step 2 prompts you to enter the basic information for the receipt, 
including order number, salesperson, and date sold. The (Format!) 
codes instruct WordPerfect exactly where to place the entry. You 
can leave an entry blank and WordPerfect will still format the 
receipt properly. 


*Step 3 sets two variables to their default values. Variable 0 is used 
to count the number of items you enter into the receipt and vari- 
able 7 is used to count the number of lines for printing each item 
at the appropriate spot. 


¢Step 4 asks you to enter the quantity, description, and unit price 
of each item. Variable 0 automatically enters the number of the 
item. For each item you add, the number in variable 0 increases 
by 1, so the first item is item #1, the second is item #2, and so 
forth. The values you enter for quantity and unit price are stored 
in variables 2 and 3, and are used in the next step. 


Step 5 calls the "computeamt" subroutine. This subroutine (found 
at the end of the macro), multiplies the quantity by the unit price, 
and copies the result into WordPerfect’s buffer. 


«Step 6 pastes the multiplied result pasted from the buffer and 
positions it in the AMOUNT column. 
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°Step 7 asks if you want to enter another item. Answering y in- 
creases value 0 by 1 and value 7 by 2. Pressing any other key takes 
you to the "terms" routine. 


eStep 8 is the "terms" routine that asks the method of payment. 
Press a number from 1 to 4. Your entry marks an X at the ap- 
propriate spot on the receipt form. 


°Step 9, the "subtotal" routine, calculates the subtotal of all the 
figures in the AMOUNT column. To do this, the macro switches 
back to Doc 2 and adds a + sign at the bottom of the calculated 
column. The number is then copied and pasted into Doc 1. 


°Step 10 calculates the sales tax. The macro switches to Doc 2, 
clears the screen, then sets up a math definition to multiply the 
entry in column A by 0.065 (6.5 percent). WordPerfect then pas- 
tes the subtotal (still in the buffer) into column A, and calculates 
the result. That figure is copied and pasted into Doc 1. 


Step 11 figures the total of the receipt. The macro first selects and 
copies the subtotal and sales tax entries previously pasted into 
Doc 1, switches to Doc 2, and pastes the numbers into a blank 
document. Next, WordPerfect adds the two numbers together, 
copies the result into the buffer, then pastes it into Doc 1. 

°Step 12 resets Doc 2 by clearing it, then turns the display on. What 
you see on the screen is nowhere near formatted the way you 
thought it would be! Don’t worry. The formatting will be correct 
when you print the form, 

eStep 13 is the "computeamt" (for compute amount) subroutine. It 
switches to Doc 2, enters the values you just gave for quantity and 
unit price, then performs a calculation. The result is copied, then 
pasted at the appropriate spot in Doc 1, 


You can readily decipher the (Format) codes in the macro using 
this formula: 


¢(Format)415xx(Enter)—Replace "xx" with the character position 
number for the entry. 


¢13xx{Enter) (Enter) (Enter}—Replace the "xx" with the line num- 
ber for the entry. 
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For example, to place the start of the entry at the 45th character 
position on the page (45 characters from the left side of the page), 
and on the 15th line, enter: 


(Format}51545(Enter) 
1315(Enter) (Enter) (Enter) 


The (Format} codes in the "items" routine use {VAR 8} to enter the 
line number automatically. {VAR 8) is initally assigned as 
19+(VAR 7). For each new item, {VAR 7) is increased by 2, so the 
first item is on line 19, the second item is on line 21, the third item 
is on line 23, and so forth. 

To determine the location for printing lines of text, create a tem- 
porary document filled with rows of numbers, starting with 1 and 
continuing to 70, or another character position, for the right margin. 
Format the document with zero margins, then print it on one of your 
forms. The result should be something like the grid in Figure 11-9. 
Use the numbers and rows to calculate the placement of each entry. 

Note that the Advance form fill-in feature works best when using 
forms designed for typewriter entry. If the form is designed for hand- 
written entry, you may have difficulty getting all the lines to fit 
properly 


AUTO-CALCULATED EXPENSE REPORT 


The next time you must complete an expense report, have Word- 
Perfect do it! Not only will it produce a cleaner final result, but its 
automatic calculation will insure that you'll get back every penny 
owed to you (on the flip side, it will also make sure that you repay 
every cent due the company). The macro shown here is particularly 
helpful for secretaries and administrative assistants who must fill 
out perhaps a dozen or more expense reports a week. 

The auto-calculated expense report uses a preformatted template, 
which is included on the Applications Disk as EXPENSES.TMP. Its 
formatting is fairly complex, making it impractical to describe here. 
Figure 11-10 shows the overall layout of the template, and how the 
report is divided into specific regions. The template is designed to 
be printed on an Okidata 192 dot matrix printer and needs the 
OKI92IBM.PRS printer definition file to work properly. Once the ex- 
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1 5 1@ 15 2@ 25 30 35 4@ 45 50 55 60 65 #70 75 6 
1 5 1@ 315 2a 25 3% 35 40 43 5A 535 6ọ 65 70 75 B8 
1 5 10 15 20 2 30 35 40 45 #5® 55 680 65 #70 753 8 
1 5 2a 25 2A 25 BRA 3A 40 430 WBa —55——69_ 65 7a 75 —— 80 
2 5 190 ā 15 ?2@ 25 30 35 40a 43 5a 35355 60 65 70 75 æ2@ 
1 5 10 15 6 20 25 30 35 4ọ HG!9- 59 — 55-60 65 —__70--—_255_80 
1 5 10 #1315 2@ 425 20 35 408 Booed 55 6@ 65 78 7535 8 
1 5 10 #35 2@ 25 #30 35 48 oo —_s5—_su-—_ 5 "70-73 88 
1 5 10 25 2@ Y 235 30 35 4@ 45 535% 53 60 65 70 75 CBO 
1 Suto 10 15 20 2 30 35 40 4GppingeeousS 60 65 709 75 BO 
1 3 10 15 20 25 30 35 40 45 3539 55 #460 65 70 75 BƏ 
1 5 je 15 29 +25 3a #35 4@ 45 sa 55 6a 65 7a 75 80 
1 5 10 +15 29 25 #30 35 #40 45 59 55 60 6535 79 73 80 
1 5 10 15 ë ë 2@ 25 29 325 40 45 _5@ 55 68 65 70 75 60 
1 5 1@ 15 2@ #=2 38 #35 480 45 50 55 609 653 70 7535 CBB 
1 8 10 15 2@ 25 a9 39 40 45 589 55 £68 65 7@ 75 80 
1 5 10 #15 2 25 30 35 4 45 S 35 60 65 79 75 480 
3 lephond ® 15 2@ship RS 3 oga 75 80 
1 5 10 15 20 25 3@ 35 40 45 5 35 60 65 70 75 80 
1 5 10 315 20 25 320 #35 40 45 59 55 68 63 #76 75 8 
1 Æ a : a 3C ~ 30 50 : 5 3—60 
1 5 OUR 5 20 25 30 io as 5e 35 eol 6s 7a! «73 80 
3 a P, A = = D a ° BO 
1 5 10 5 20 52 753 6a 
1 % Q p j BQ 
1 5 30 5 20 52 73 80 
2 9 s @ BO 
1 5 30 5 2 73 00 
i % t @ —890 
1 5 10 h5 2e 75 B® 
1 @ BS 
1 5 10 45 2@ 2 35 40 45 538 35 75 8O 
1 2 Q 5—_—_3@——_955 otse Ae 
1 5 10 hS 2% 25 30 #35 4M0 43 5o 355 6@ 73 60 
1 2 H 2a 25 -_ 3@-—__ 355 _4@__ eee Be 
1 5 10 15 20 #25 30 35 40 45 #58 3535 60 753 80 
1 i: l 2g; 5——_320—_355_ —40@—__45-—_58—_35-—_ 6 Be 
1 5 10 5 20 25 3@ 35 4 45 59 353 68 73 62 
1 2 @ ae @—_45—__38 — 55-64 BO 
1 5 10 5 2@ 25 3@ 35 40 45 S® 55 68 75 6 
3 z °, ` o, 2 = A a a A @ 
1 5 18 5 20 25 30% 35 40 45 5% 53 68 75 6a 
2 . . DO B 2 = 5 Ba 
1 5 12 5 20 25 30 35 40 #45 59 553 68 75 80 
1 2 @——_ 25 __30@—_35s5_ —_4@-_45-__40 —_35-— 6 BO 
1 8 10 5 2@ 25 230 35 4 45 39 55 68 75 Bø 
3 g 2 a5 2 @—+5-—_36 35556 x") 
1 8 10 5 20 25 30 35 40 45 5% 35 6 73 6 
1 a {© 2 2 e@—_~5-———__5@—_35—_6e ; 

1 83 12 5 2% 25 30 35 40 45 S® 5355 68 75 BO 
i > Q z 2 oe BO 
1 5 10 5 20 25 30 59 65 70| 73 82 
1 a E OQ os y, oe we pA a Zi BO 
1 5 20 2 25 39 35 40 45 S® SS 60 65,, B 753 80 
1 JEMS jg Chs sta 25 3% 35 40 45 5a 553 6 65 —75s Be 
1 83 10 15 20 #25 30 33 #40 45 59 55 6 6S soj 753 6 
1 5 s 29 #2 30 35 #40 45 50 SS 68 63 —7s Ba 
1 5 1@ 15 2@ 23 30 35 #40 45 5a 5353 6@ 63 73 82 
1 5 id AE" 53 25 30 235 40 45 5 55 60 65 o 75 80 
1 5 3 15 2% 25 30 #35 4a #45 S@ 55 6@ ooff nde 75 862 
12 35 i MOR TBOnee 25 30 35 40 #45 50 55 6 6 75 00 
1 3 20 25 30 35 4a 45 50 55 60 Ano 2% _75 80 
2 35 60 #65 70 75 B8 


FIGURE 11-9 SAMPLE NUMBERED GRID OVER FORM 
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Name <name> Week Ending <w/e> Date <date> 
Week 

Day/Date Sun Mon Tue Wed Thu Fri Sat Totals 
Destination 


Business Miles 


Day/Date Sun Mon Tue Wed Thu Fri Sat Totals 


Cash Expenses 


Meals 0.00 
Lodging 0.00 
Telephone 0.00 
Gas and Oil 0.00 
Auto Repair 0.00 
Tolls 0.00 
Parking 0.00 
Entertainment 0.00 
Other 1 0.00 
Other 2 0.00 
vieekly Totals 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 
Mileage (from above) 

TOTAL $0.00 


Summary of Expenses 

Total Charged Expenses: 

Total Cash Expenses: 

Total Expenses: 0.00 


Summary of Mileage 

Ending Odometer Reading: 

Beginning Odometer Reading: = 
Total Odometer Miles: 0 
Personal Miles: = 


0 
Total Business Miles: 0 
Balance 
Outstanding Cash Advance Total Cash Expenses Balance Due* 


0.00 
* ($886.48) due company S$#4&.4# due employee 


Signature and Approvals 


FIGURE 11-10 EXPENSES.TMP DOCUMENT 
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pense template is filled in, you can change the printer definition to 
your printer. The Okidata 192 printer driver was used because the 
STANDARD.PRS printer definition makes the template too wide to 
fit on an 8 1/2 by 11 inch page. Feel free to modify the expenses 
template to conform to your printer, but be warned that the template 
document requires very specific formatting. You may need to also 
modify the macro if you change the EXPENSES.TMP document. 

The macro automatically calls up the EXPENSES.TMP document 
when it starts. You are then prompted to enter the following infor- 
mation: 


°Your name. 
°Week ending for expenses. 
°Today’s date. 


°Destinations for the week (you can enter a different destination 
for each day by pressing the [Right] key). Press [Enter] when 
you are done. 


o Business miles each day (on your car). Press the [Tab] key to 
move through each day; press [Enter] when you are done. 


°Cash expenses for meals, lodging, telephone, gas and oil, auto 
repair, tolls, parking, entertaining, and two miscellaneous items. 
Press the [Tab] key to move through each day; press [Enter] 
when you are done. 


°Total charged expenses (on company credit card). 


°Ending and beginning odometer reading for a company car, plus 
personal miles. 


eOutstanding cash advance, if any. 


The expense report automatically calculates business miles and 
multiplies it by 22 cents per mile (you can modify the math defini- 
tion if required). The totals for each cash expenditure, as well as 
daily totals, are calculated for you. The TOTAL shows the cash ex- 
penses plus any business mileage. 

The Summary of Expenses is a convenience your company may not 
require. It shows the total for cash expenses (taken from the pre- 
vious calculation) and total charged expenses on company credit 
cards (or personal credit cards, when filling out a separate credit ex- 
pense report). The Summary of Mileage is different from the Busi- 
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ness Miles entry earlier in the report. You would use this section if 
you drive a company car or had the use of a company-owned (or 
rented) car sometime in the week. WordPerfect automatically calcu- 
lates the total mileage, based on the beginning and ending odometer 
readings, and subtracts any personal mileage. 

The Balance subtracts the expense total from an outstanding cash 
advance, if any. If you owe the company money, the amount is shown 
in parenthesis. If the company owes you, the amount is shown alone. 


Here is an inside look at the EXPENSES.WPM macro. 


EXPENSES.WPM (CHAPI11 directory on Applications Disk) 
1. (Retrieve) EXPENSES.TMP(Enter) 
{Home}(Home} (Up) 
2. (ASSIGN) 0~(STATE) &256~ 
(IF) (VAR 0)=256~(GO)start~ 
(ELSE) (CALL)typeon~ 
{END IF) 
3. (LABEL)start~ 
(TEXT) 1~(“R)Please enter your name. {^S}. -~ 
(Replace)n ame(Search) (VAR 1) (Search) 
(TEXT) 1~{4R) Enter week ending. {^S} -~ 
(Replace}nw/e(Search) (VAR 1) {Search} 
(TEXT) 1~(4R) Enter today’s date. (“S}- -~ 
(Replace})date(Search) (VAR 1})(Search} 
4. (Search) Destination (Search) (Right) 
(PROMPT) {‘R)Enter destinations for week; press Enter when 
finished. (^S). -~ 
(CALL})wait_enter~ 
5. (Search)Business Miles(Search) (Right) 
(PROMPT) (^R) Enter business miles for each day; press Enter 
when finished. (^S). -~ 
(CALL) wait, enter~ 
6. (Math/Columns)2 
(Left) (Block) (Word Left) 
(Move) 12(Cancel} 
1. (Search) Meals(Search) (Right) 


(PROMPT) (^R) Enter meals for each day; press Enter when 
finished. {^S}. -~ 


(CALL) wait, enter~ 
(Search)Lodging(Search) (Right) 
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{PROMPT} {*R)Enter lodging for each day; press Enter when 
finished. {^S}. -~ 

(CALL)wait_enter~ 

(Search)Telephone (Search) (Right) 

(PROMPT) (*R)Enter phone calls for each day; press Enter 
when finished. {4S}: -~ 

(CALL)wait_enter~ 

(Search)Gas and Oil{Search) (Right) 

(PROMPT)(^R) Enter gas and oil expenses for each day; press 
Enter when finished. {4S}: ~ 

(CALL)wait_enter~ 

(Search}Auto Repair(Search) (Right) 

(PROMPT) (“R) Enter auto repair expenses for each day; press 
Enter when finished. {^S} -~ 

(CALL) wait_enter~ 

(Search)Tolls(Search) (Right) 

(PROMPT) ({“R)Enter toll expenses for each day; press Enter 
when finished. (^S). -~ 

(CALL)wait_enter~ 

(Search) Parking(Search) (Right) 

(PROMPT) {‘R) Enter parking expenses for each day; press 
Enter when finished. (^S). ~ 

(CALL) wait_enter~ 

(Search) Entertainment(Search) (Right) 

(PROMPT}(‘R) Enter entertainment expenses for each day; 
press Enter when finished. (4S): ~ | 

(CALL) wait_enter~ 

(Search)Other 1(Search) (Right) 

(PROMPT) (^R) Enter miscellaneous expenses for each day; 
press Enter when finished. (^S). -~ 

(CALL) wait_enter~ 

(Search)Other 2(Search) (Right) 

(PROMPT) (^R) Enter miscellaneous expenses for each day; 
press Enter when finished. (^S) ~ 

(CALL) wait_enter~ 

8. (Math/Columns}2 (Search)(from above)(Search) 
(End) (Move}41 
(Math/Columns)2 
9. (Search)$(Search) 
(Block) (End) (Left) 
(Move}12(Cancel) 


284 WordPerfect 5.0 Macros and Templates 


10. (Search) Charged Expenses(Search) (Right} 


(PROMPT) (4R)Enter total charged expenses; press Enter 
when finished. {AS}- -~ 

(CALL) wait_enter~ 

(Search)Cash Expenses{Search) 

(Right) (Right(Right} 

(Move}41 

(Math/Columns}2 


11. (Search)Ending Odometer Reading:(Search) 


(Right) (Right) (Right) 

(PROMPT)(‘R)Enter ending odometer; press Enter when 
finished. {^S}. -~ 

(CALL) wait_enter~ 

(Search) Beginning Odometer Reading:{Search) 

(Right) (Right) (Right) (Right) 

(PROMPT){4R}Enter beginning odometer; press Enter when 
finished. {4S}- -~ 

(CALL) wait_enter~ 

(Search}Personal Miles:{Search) 

(Right) (Right) (Right) (Right} (Right) (Right) 

(PROMPT}{4R)Enter personal miles; press Enter when 
finished. (4S)- -~ 

{CALL} wait_enter~ 


12. (Math/Columns)2 
1% (Search)*{Search) 


14. 


(Right) (Right) 

(PROMPT) (“R) Enter outstanding cash advance; press Enter 
when finished. {4S)- -~ 

(ASSIGN) 2~~ 

(LABEL)loop1~ 

(VAR 2) 

{LOOK}2~ 

(IF)"(VAR 2}"="(Enter)"~ 

(ELSE) (GO)loop1~ 

(END IF} 

(Right) (Right) (Right) (Right) 

{Move}41 

(Math/Columns)2 

{Home} {Home} (Up) 

(QUIT) 


15. (LABEL) wait_enter~ 
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(ASSIGN) 2~~ 

(LABEL) loop~ (VAR 2) 
(LABEL)returntab~ 

(LOOK)2~ 

(IF)" (VAR 2)"="(Enter)}"~(GO)enter~ 


(Right) (Right) 
(GO)returntab~ 
17. (LABEL) enter~ 
(End) 
(RETURN) 
18. (LABEL)typeon~ 


(Typeover) 
(RETURN) 


o°Step 1 retrieves the EXPENSES.TMP template document and 
brings the cursor to the top (if it’s not already there). 


eThe expense report system works with typeover on. Step 2 checks 
to see if typeover is on, and ifit isn’t, it branches off to the "typeon" 
subroutine. 


eStep 3 asks for your name. Your entry is stored in variable 1, 
which is used as the Change To string in a replace command. The 
process is repeated for the week ending and today’s date entries. 


Step 4 searches for the text "Destination." After finding it, Word- 
Perfect prompts you to enter the destinations for the week. To 
properly enter destinations for each day, press the [Right] key. 
Once the prompt appears, the macro branches off to the 
“wait_enter subroutine, which waits for you to press the [Enter] 
key. When the [Enter] key is struck, the macro continues on. 


¢Step 5 searches for the text "Business Miles." Once found, you are 
prompted to enter the mileage for each day. Press the [Tab] key 
to go from day to day. Press [Enter] when finished. 


¢Step 6 adds up the mileage you have entered and multiplies it by 
22 cents per mile. The result is entered in the Week Totals column 
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opposite the Business Miles heading. The Macro then selects the 
calculated figure and copies it. The (Cancel} command after the 
copy operation prevents the contents in the buffer from being 
pasted the next time you press the [Enter] key. 


Step 7 prompts you to itemize the expenses for the week. Press 
the [Tab] key to go from day to day. Press [Enter] when finished. 


¢Step 8 calculates the amounts you have entered, then pastes in 
the mileage figure previously copied. Then, once more, Word- 
Perfect calculates the expense report, adding together the week's 
subtotals and the mileage. 


¢Step 9 searches for the $ symbol, selects the recently calculated 
TOTAL, then copies it into the buffer. 


¢The macro searches for the text "Charged Expenses’ in Step 10, 
prompting you to enter the amount. It then searches for "Cash Ex- 
penses" and automatically pastes in the TOTAL from the buffer. 


eStep 11 searches for the text "Ending Odometer Reading:" and 
once found, asks you to enter the mileage. The macro then sear- 
ches for "Beginning Odometer Reading:" and asks for that figure. 
You are then prompted to enter any personal mileage. 


eIn Step 12, the mileage figures are tallied. 


¢Step 13 searches for the "*" character that appears after Balance 
Due in the Balance section of the report. The macro then asks you 
to enter the outstanding cash advance amount. 


*Step 14 finishes the report by placing the previously copied 
TOTAL into the Total Cash Expenses column and calculating the 
balance. 


¢Step 15 is the "wait_enter" subroutine. WordPerfect waits for you 
to press two keys: either [Enter] or [Tab]. When you press the 
[Enter] key, the macro branches off to the "enter" subroutine. 
When you press the [Tab] key, the macro branches off to the ‘tab’ 
subroutine. 


Step 16 is the "tab" subroutine. When you press the [Tab] key, 
the macro blocks the normal [Tab] code and treats it as if you 
pressed the [Right] key twice. This step is necessary to prevent 
the [Tab] codes from upsetting the format of the template. 


eStep 17 is the "enter" subroutine. The macro blocks the [Enter] 
key and treats it as if you had pressed the [End] key. This is also 


Name Karen Cax 


Day/Date Sun Mon Tue Wed 
Destination Boston New York 
Business Miles 24 120 19 
Day/Date Sun Mon Tue Wed 
Cash Expenses 
Meals 25 87 38 10 
Lodging 76 87 44 44 
Telephone 6 
Gas and Oil 
Auto Repair 
Tolls 2 4.50 
Parking 8 8 0 
Entertainment l 
Other 1 
Other 2 
Weekly Totals 109.00 184.00 88.00 58.50 
Mileage (from above) 
TOTAL 
Summary of Expenses 
Total Charged Expenses: 
Total Cash Expenses:. 770.22 
Total Expenses: 770.22 
Summary of Mileage 
Ending Odameter Reading: 14,654 
Beginning Odometer Reading: -14,120 
Total Odometer Miles: 534 
Personal Miles: -0 

0 
Total Business Miles: 534 
Balance 
Outstanding Cash Advance Total Cash Expenses 


770.22 
$388.88 due employee 


1000 
* ($##3.#3) due company 


Signature and Approvals 
Employee Signature 
Approval 


Approval 


Week Ending 4/15 
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Date 4/15 

Week 

Thu Fri Sat Totals 
Memphis 
43 120 71.72 

Thu Fri Sat Totals 

0 127 287.00 

98 19 368.00 

12 18.00 

0.00 

0.00 

6.50 

3 19.00 

0.00 

0.00 

0.00 

113.00 146.00 0.00 698.50 
71.72 

$770.22 


Balance Due* 
(229.78) 


FIGURE11-11 FILLED IN EXPENSE REPORT 
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necessary to prevent additional [HRt] codes from upsetting the 
format of the template. 


An example of a filled-in expense report is shown in Figure 11-11. 


CHAPTER 12 
MAILING LABELS AND 


ENVELOPES 


i OT writing and printing an envelope in just 10 seconds; or for- 
matting the names and addresses for 3-up label stock in fifteen 
seconds. Such speedy efficiency is natural to WordPerfect if you first 
develop some simple macros for automating the chore. You will not 
only spend less time manually formatting the names and addresses 
(a tedious and thankless job at best) you will also save label and en- 
velope stock. Because WordPerfect controls the formatting for you, 
once you get the system down you can repeat the process over and 
over again with the same accurate results. 

This chapter presents several macros for the preparation and 
printing of labels and envelopes. Although the macros are geared 
toward labels and envelopes for mailing purposes, you can use them 
whenever you need to prepare tags, cards, tickets, and other small 
printed matter. For example, you can just as easily use the macros 
to prepare labels for spice bottles, school lockers, personalized book- 
marks—you name it. If you can gett the paper into the printer, Word- 
Perfect can print on it. 
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This chapter contains macros for: 


¢Printing one-up labels. 
¢Printing three-up labels. 
¢Printing on envelopes. 


e Adding graphics to labels and envelopes. 


PRINTING ONE-UP LABELS 


Label stock is available in all shapes and sizes. Acommon label stock 
measures 3 1/2 by 15/16 inches. The individual labels are applied in 
one column on a continuous pin-fed sheet for use in daisywheel and 
dot matrix printers. A slight gap between each label on the sheets 
places the labels exactly one inch apart from one another. 

You can use WordPerfect to print on these "one-up" labels in a 
variety of ways. In one method, you print each label separately by 
entering the text from the keyboard. When you are done with one 
label, WordPerfect prints it, then readies itself for another label. You 
can also print a batch of labels using names and address merged 
from a secondary file. 


Direct Printing 


To print on label stock, not only must you change WordPerfect’s 
default margins, but you must specify a page length that matches 
the depth of each label. The following macro does both automatical- 
ly, and even prints the label for you when you are done. You should 
have the label stock set up in your printer before using the macro. 
The macro is designed so that it can be used while you are working 
on another document. WordPerfect uses Doc 2 as a temporary 
scratch pad for the label text. 

The first version of the macro requires a predefined form called 
1 Up Labels, or the macro will not work. The definition of the form 
is shown in Figure 12-1. You can readily duplicate this form defini- 
tion for use with your printer. For ease of use, edit the [ALL 
OTHERS] form definition so that it say "initially present." 
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Doc 1 Pg 1 Ln 1 Pos 18 


CHRtI 
CHRtI 
CHRtI 
CHPg] 
“F1“CHRtI 
“F2*CHRtI 
“NCHPg] 
“F1*CHRtI 


Press Reveal Codes to restore screen 


FIGURE12-1 FORM DEFINITION 


PRLABEL.WPM (CHAP12 directory on Applications Disk 
1. (ON NOT FOUND) (GO)not found~ 
(DISPLAY OFF) 
(Switch) 
2. (LABEL})start~ 
(ExGt}nn 
{Format} 170(Enter)0{Enter) (Enter) 
250(Enter) 0(Enter) 
803" (Enter)"1 (Enter) 
8n1 Up Labels(Enter)1 
79(Enter) (Enter) 
3. (DISPLAY ON) 
(PROMPT) Enter the text for the label (up to four lines); (Enter) 
Press Ctrl-C when finished. - -~ 
(ASSIGN) 1~~ 
{LABEL} loop~ 
(VAR 1) 
(LOOK) 1~ 
{(IF)" (VAR 1}"="(4C)"~(GO)done~ 
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(ELSE) (GO}loop~ 
(END IF) 
4, {LABEL)done~ 
(Print) 1(Print)4 
(CHAR}2~Do another (y/n). -~ 
(F)"(VAR 2)"="y"~(DISPLAY OFF) (Exit) {GO)start~ 
(ELSE) 
(EJ"(VAR 2)"="Y"~(DISPLAY OFF) {Exit} (GO}start~ 
(ELSE) 
CF)" (VAR 2}"="n"~{GO}quit~ 
(ELSE) 
(IE)" (VAR 2)"="N"~(GO}quit~ 
(ELSE) 
(END IF) (END IF) (END IF) (END IF) 
5. (LABEL) quit~ 
(DISPLAY OFF) 
(Ext) (Exit)nn{Switch} (DISPLAY ON} 
6. (LABEL)not found~ 
(BELL) 
(PROMPT)Sorry. The 1-up labels form definition can’t be found.~ 
(WAIT)20~ 
(Ext) (Exit) (Exit) ((Exit)~~ 
(QUIT) 


Step 1 on turns off the display and switches to Doc 2 (assuming 
you are in Doc 1). It also tells the macro what to do if the name 
search in the next step fails. 


Step 2 sets up the formatting for the labels, specifically: 
¢Top and bottom margins: 0" 
e Right and left margins" 0" 
ePaper Size: 3" by 1" 
ePaper Type: 1 Up Labels (predefined form) 


eNo page numbering (in case page numbering has been set asa 
default) 


¢Step 3 turns the display back on and asks that you enter the text 
for the label. You can enter up to four lines (a "comfortable" fit, 
though you can cram up to six lines on the label). The prompt dis- 
played at the bottom of the screen may disappear as you type or 
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when you press the [Enter] key. This is normal and caused when 
WordPerfect rewrites the screen. Pressing [Ctrl]-C signals Word- 
Perfect that you are done and ready to print. 


°Step 4 is the "done" routine, called up when you press [Ctrl]-C. 
The macro automatically chooses print and selects the Go com- 
mand. The Go command is not always required, so you may 
remove it without harming the operation of the macro. After print- 
ing, you are asked if you want to do another label. Answer y for 
yes for n for no. Answering yes brings you back to start, where 
you can now enter the text for another label; answering no jumps 
you to the "quit" routine. 


oStep 5 is the "quit" routine. It merely turns the display off, exits 
from Doc 2, then switches to Doc 1. The display is turned back on 
so you can return to work. 


°Step 6 desplays a message when the macro can’t find the 1-up 
labels printer form definition. The macro then returns to the docu- 
ment and quits. 


A second version of the macro, shown here, does not specify the 
predefined 1 Up Label stock. This macro is the same as the previous 
one but lacks the 1 Up Label instructions at the end of Step 2. 


PRLABEL1.WPM (CHAP12 directory on Applications Disk) 
1. (DISPLAY OFF) 
(Switch) 
2. (LABEL}start~ 
{Exit}nn 
(Format) 170(Enter}0{Enter) (Enter) 
250{Enter)0(Enter) 
803" (Enter)"1({Enter) {Enter} 
79(Enter) (Enter) 
3. (DISPLAY ON) 
(PROMPT)Enter the text for the label (up to four lines); (Enter) 
Press Ctrl-C when finished. -~ 
{ASSIGN} 1~~ 
(LABEL) loop~ 
(VAR 1) 
{LOOK)1~ 
(IF)"(VAR 1}"="(4C)"~{GO)}done~ 
(ELSE) {(GO)loop~ 
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(END IF) 
4, (LABEL) done~ 
(Print}1{Print)4 
(CHAR)2~Do another (y/n). -~ 
(IF) (VAR 2}"="y"~(DISPLAY OFF) (Exit) (GO}start~ 


(ELSE) 

(IF)"(VAR 2)"="Y"~(DISPLAY OFF) {Exit) {GO) start~ 
(ELSE) 

(IF}" (VAR 2}"="n"~(GO}quit~ 

(ELSE) 


(TF}" (VAR 2)"="N"~(GO) quit~ 

(ELSE) (END IF} {END IF){END IF) {END IF) 
5. (LABEL) quit~ 

(DISPLAY OFF) 

(Exit) (Exit}nn(Switch) {DISPLAY ON} 


If you are using a form type not recognized by WordPerfect for 
your printer, the program will halt and ask that you change paper 
in the printer and press the "Go" command in the Control Printer 
option under the Print menu. While this poses no serious trouble 
when printing manually, the slight delay as WordPerfect readies it- 
self for printing can cause the macro to “outrun" itself. Even if you 
give the command to "Go" print, the macro will issue it before Word- 
Perfect has displayed the prompt. 

The easiest solution is to build a delay between the time you in- 
itiate print and give the "Go" command. You may also build a prompt 
of your own in the macro that asks to ready the printer and press 
number 4, the "Go" key. If your macro is outrunning the print 
process, add these two lines after the {Print)1 instruction in the 
"done" routine: 


{CHAR)1~Ready the printer and press 4.~ 
{VAR 1) 


The {CHAR) statement pauses macro execution and waits for you to 
press a key. It should be key 4, to instruct WordPerfect to print. The 
key you press is stored in variable 1, which is passed through to 
WordPerfect with the [VAR 1) instruction. 
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Merge Printing 


Use this short macro if you have lots of labels to print, or are print- 
ing them from an address database. The 1UPLABEL.MRG merge 
document used in the macro, and shown in Figure 12-2, is really an 
unformatted file with nothing but the conventional ^F#^ merge 
codes. All of the formatting for the labels comes from the macro. 
However, the LUPLABEL.MRG must already exist on your disk or 
the macro will respond with a FILE NOT FOUND message. 

To use the macro, the list of names and addresses should be in- 
cluded in a secondary merge file named ADDRESS. Of course, you 
are free to use another secondary merge file name as long as you 
change the macro accordingly. 

You should construct the LUPLABEL.MRG file to correspond with 
the formatting of the fields and records in your ADDRESS name and 
address file. Several approaches to organizing the data on the mail- 
ing labels are shown in Figure 12-3 


FIGURE 12-2 1UPLABEL.MRG DOCUMENT 


D: \UWPSA8\TEXT\1UPLABEL. MRG Doc 1 Pg 1 Ln Z Pos 18 


F1CCHRŁ] 


Press Reveal Codes to restora screen 
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Arnold Fletcher 
587 Maple Ave. 
Los Angeles, CA 91765 


Fletcher, Amold 

587 Maple Ave. 

Los Angeles, CA 91765 
Account # 4309876 


Mr. Amold Fletcher 
Good Food Deli 

587 Maple Ave. 

Los Angeles, CA 91765 


Good Food Deli 

587 Maple Ave. 

Los Angeles, CA 91765 

ATTN: Mr. Amold Fletcher, Owncr 


O 
O 
O 
O 
O 
O 
© 
O 
O 
O 
O 
O 


oOoooooooooooO 


FIGURE 123 SAMPLE PRINTED RESULTS ON LABELS 


IUPLABEL.WPM (CHAP12 directory on Applications Disk) 
1. (Merge/Sort}1 
1UPLABEL.MRG(Enter) 
ADDRESS {Enter} 
2. {Home} (Home}{Up) 
(Format) 170(Enter}0{Enter} (Enter) 250({Enter}0 (Enter) 79 
803" (Enter) 1"{Enter}4(Enter) (Enter) 


*Step 1 initiates a merge and selects IUPLABEL.MRG as the 
primary merge file and ADDRESS as the secondary merge file. 


*After merging, Step 2 formats the document with 0" margins all 
around and selects a page size of 3" by 1". 


After the macro has finished, load the label stock and print. 
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Alignment mark 


FIGURE 12—4 TOP ALIGNMENT OF LABEL STOCK 


Compensating for Differences In Printers 


The label macros above start printing on the first line. Some printers 
don’t allow this and need from a quarter-inch to as much as a full 
inch of extra space before they can print the first line. If yours falls 
into this category, you’ll need to adjust the label stock in the printer 
so that the first line corresponds with the top of a label, as illustrated 
in Figure 12-4, With some practice, you will learn how much extra 
space to give so that the labels are printed properly 


PRINTING THREE-UP LABELS 


One-up labels require your printer to have an adjustable tractor or 
pin-feed mechanism. If you can’t adjust the distance between the 
tractors, you will find it difficult to use the narrow one-up label stock. 
One alternative is to use three-up label stock—three labels across a 
standard 8 1/2-inch paper backing (the actual width, adding the trac- 
tor holes, is 9 1/2 inches). 

Three-up labels require some extra formatting on your part, but 
they are no more difficult to prepare than one-up labels. Enter this 
macro and you'll be printing three-up labels at the touch of a key. 
The macro assumes you will be merging the names and addresses 
from a secondary merge file. 
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-S8UPLABEL.MRG (CHAP12 directory of Applications Disk) 
1. (Merge/Sort) 1 
3UPLABEL.MRG(Enter} 
ADDRESS (Enter} 
2. (Home) (Home) {Up} 
{Format} 170) (Enter)0{Enter) (Enter) 
250{Enter)0(Enter} 
79 
808.5" (Enter) 1"(Enter)4 (Enter) {Enter) 
3. Math/Columns)423(Enter) 
30(Enter} 
4.25{Enter) 
3(Enter} 
3(Enter} 
5.75 (Enter) 
5.75{Enter) 
8.5{Enter} (Enter)3 
4, (Home}(Home} (Down) 
(Home) {Home} (Up) 


*Step 1 initiates a merge and selects 3UPLABEL.MRG as the 
primary merge file and ADDRESS as the secondary merge file. 


eAfter merging, Step 2 formats the document with 0" margins all 
around and selects a page size of 8.5" by 1". 


Step 3 sets column formatting: 
¢Number of columns: 3 

*Spacing between columns: 0" 
¢Margins for Column 1: .25" and 3" 
¢Margins for Column 2: 3" and 5.75" 
¢Margins for Column 3: 5.75" and 8.5" 


At the end of this step the macro turns columns on. 


¢Step 4 formats the document into columns by moving the cursor 
to the end of the file, then back to the beginning. 


The merged document can now be printed. 
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D: \UPSE\ TEXT\LASERLAB. MRG . Doc 1 Pg 1 Ln 1 Pos 10 


EE RY Yor eee 2 - = . 
AYA Jeli tetsl v4 heal AAC Col Def:4,6,25",6.3",8.3",3,.05",3.85",5.8",5.8",8.5 J€Bloc 
k Pro:OnJCCol OnIJCHRt] 
CHRE] 
CHRtJ 
CHRtI 
CHPgJ 
“F1*CHRtI 
“F2°CHRtI 
“NCHPg] 
“F1“CHRtI 


Press Reveal Codes to restore screen 


FIGURE12-5 FORMAT SCREEN FOR LASER PRINTING 


The macro sets the margins for the typical size of three-up labels 
for use on dot matrix and daisywheel printers. You may wish to ex- 
periment with the margin settings, to adjust the print for the par- 
ticular label stock you use. 

If you are using a laser printer, include the page formatting in the 
primary merge document, as shown in Figure 12—5, and remove the 
formatting instructions from the macro. Be sure to place “F# codes 
in each of the three columns in the primary merge document, as il- 
lustrated in the Figure. 


PRINTING ON ENVELOPES 


Printers equipped with carriages 10 inches or wider, as well as most 
laser printers with a cut sheet bypass, can be used to print directly 
on #10 business envelopes. Just like printing on labels, using en- 
velopes with your printer requires you to reset formats and careful- 
ly monitor where the name and address text is going. A macro takes 
the guesswork out of envelope printing. 
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The ENVELOPE.WPM macro does not use any type of prefor- 


matted template document. It creates the format and even the 
return address automatically (omit the return address if you are 
using preprinted envelopes). The macro makes one envelope at a 


time from data you enter manually from the keyboard. 


ENVELOPE.WPM (CHAP12 directory on Applications Disk) 


1. (LABEL)start~ 

(DISPLAY OFF} 

(Format) 170(Enter)0{Enter) (Enter) 

250(Enter)0(Enter} 

79 

85{Enter) (Enter) (Enter) (Enter) 

. Your Name Here(Enter) 

Your Address Here(Enter} 

City, State, ZIP{Enter) 

{Enter} (Enter) (Enter) (Enter) (Enter} (Enter) {Enter} 

(Enter) 

(Format) 173(Enter) (Enter) {Enter) (Enter) 

. (DISPLAY ON} 

(PROMPT)Enter name and address; press Ctrl-C when 
finished. -~ 

. (LABEL})ctrl-c~ 

(ASSIGN) 1~~ 

(LABEL}loop~ 

(VAR 1) 

(LOOK) 1~ 

(IF)" (VAR 1)"="(4C}"~(GO)finished~ 

(ELSE) (GO)loop~ 

(END IF) 

. (LABEL)finished~ 

(Print) 1(WAIT)20~ 

. (LABEL}doanother~ 

(CHAR}2~Do another? (y/n). -~ 

(IF)" (VAR 2)"="y"~(Exit)nn (GO}start~ 


(ELSE) 

IF)" (VAR 2)"="n"~(GO)quit~ 
(ELSE) 

(END IF) (END IF) 


(PROMPT) Press "y" or "n" only. - -~(BELL) (WAIT) 15~ 
(GO}doanother~ 
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7. (LABEL) quit~ 
(Exit}nn 


oStep 1 turns the display off and sets these formats: 
°Left/right margin: 0" 
°Top/bottom margin: 0" 
oNo page numbering 
° Paper Size/Type: Envelope (4.5" by 10") 


o Step 2 prints the return name and address, then adds eight blank 
lines and resets the left margin to 3". 


oStep 3 turns the display on (part or all of the return address is 
pushed off the side of the screen), and asks you enter the 
addressee’s name and address. Press [Enter] to go down a line; 
press [Ctrl]-C when finished. 


oStep 4 checks to see if you have pressed [Ctrl]-C. If you haven't, 
it passes the characters you type through to WordPerfect, and 
they are printed on the envelope. When you finally press [Ctrl]- 
C, the macro branches off to the "finished" routine. 


oStep 5 is the "finished" routine that prints the envelope after you 
have typed in the particulars. The macro waits two seconds for 
the bulk of the printing to be done, then moves on to the next step. 


eStep 6 asks if you want to do another envelope. Answering yes 
repeats the process by essentially starting the macro over again. 
Answering no jumps the macro to the "quit" routine. 


°Step 7, the "quit" routine, clears the screen. 


Using Fonts 


If you'd like to dress up your envelopes, embed font size and attribute 
codes within the macro. For example, to make the return address 
bold and large, press these keys before and after the return address 
block: 


Key Sequence What it Does 
1. [(Ctrl]-[F8] Selects Font menu. 
2.1 Chooses Size option. 
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3.5 Selects Large font size. 

4, (Ctrl]-[F8] Reselects Font menu. 

5. 2 Chooses Appearance option. 
6.1 Selects Bold. 


You can change the font size and style for the address block by 
repeating the above steps. Place the "on" codes immediately after 
Step 2 of ENVELOPE.WPM. You don’t need to turn them off because 


they will be forgotten when you leave the macro and erased if you 
choose to print another envelope. 


ADDING GRAPHICS TO LABELS AND 
ENVELOPES 


Even if you’re not using preprinted envelopes, you can still add a 
company logo or design by taking advantage of WordPerfect’s 
graphics feature. The graphic image is sized, rotated, edited, and 
cropped as needed, and stored in an envelope template. You recall 
the template using a macro, then enter the addressee information. 
The same basic approach can be used to create labels, cards, tags, 
and tickets with embedded graphics. Change the paper size and 
make trial printouts until you position the graphics and text the way 
you want. 

The graphics envelope template, saved as ENVELOPE.TMP, is 


shown in Figure 12-6. The formats for the template are shown in 
Figure 12-7. 


ENVGRAPH.WPM (CHAP12 directory on Applications Disk) 
1. (LABEL)start~ 
(DISPLAY OFF) 
(Retrieve) ENVELOPE.TMP(Enter} 
(Home) (Home) (Down) 
2. (DISPLAY ON) 
(PROMPT)Enter name and address; press Ctrl-C 
when finished. - -~ 
3. (LABEL) ctrl-c~ 
(ASSIGN) 1~~ 
(LABEL)loop~ 
(VAR 1) 
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John Alexander Burke 
PO Box 1809876 


Los Angeles, CA 9886S 


heed BL ARAR als BUR TMP Doc 1 Pg 1 Ln 1 Pos 2.5 


CL/R Mar: v. 25". 0.01 "ICT/B Mar:0. 01’, 0.01" ICPg Numbering:No page numberingll Paper 
Sz/Typ: 18,5” x 4”, Standard) 

CFigure:1;:PENCIL.UPG:JJohn Alexander BurkelHRt] 

CHRt] 

PO Box 169876CHRtI 

CHRtI 

Los Angeles, CA S3BS6SCHRtI 

CHRtI 

CHREJ 

CHRtI 


Press Reveal Codes to restore screen 


FIGURE12-6 ENVELOPE TEMPLATE 


FIGURE 12-7 ENVELOPE FORMATS 


Jobn Aloxandor Berra 
DO Box 109876 
Laa Angelos, CA 9006S 
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(LOOK) 1~ 

(IF)"(VAR 1}"="(4C)"~(GO)finished~ 
(ELSE) (GO)loop~ 

{END IF) 


4, {LABEL)finished~ 
{Print}1 (WAIT}100~ 
5. (LABEL) doanother~ 
{CHAR)2~Do another? (y/n). -~ 
(IF}" (VAR 2}"="y"~{Exit}nn(GO}start~ 
(ELSE} 
(IF)" (VAR 2)"="n"~{GO)quit- 
(ELSE) 
(END IF} (END IF) 
(PROMPT)Press "y" or "n" only. - -~(BELL)}(WAIT}15~ 
(GO)doanother~ 
7. (LABEL) quit~ 
(Exit)nn 


Step 1 turns the display off and retrieves the ENVELOPE.TMP 
file. The macro then moves the cursor to the very bottom of the 
template. 


Step 2 turns the display on (part or all of the return address is 
pushed off the side of the screen), and asks you enter the 
addressee’s name and address. Press [Enter] to go down a line; 
press [Ctrl]-C when finished. 


Step 3 checks to see if you press [Ctrl]-C. If you don’t, it passes 
the characters you type through to WordPerfect, and they are 
printed on the envelope. When you finally press [Ctrl]-C, the 
macro branches off to the "finished" routine. 


eStep 4 is the "finished" routine that prints the envelope after you 
have typed in the particulars. The macro waits ten seconds for the 
bulk of the printing to be done, then moves on to the next step (you 
may increase or reduce the wait as needed). 


¢Step 5 asks if you want to do another envelope. Answering yes 
repeats the process by essentially starting the macro over again. 
Answering no jumps the macro to the "quit" routine. 


¢Step 6, the "quit" routine, clears the screen. 


CHAPTER 13 
RESUMES 


A clean, well-prepared resumé may not always guarantee that 
you'll land your next job, but it sure can help. Some people write just 
one resumé and send copies to all prospective employers; others 
tailor each resumé to the particular job they are applying for. Either 
way, you will find WordPerfect macros and templates a welcome ad- 
dition to your job hunting tool box. 

A resumé macro not only helps you assemble your resumé in one 
of several accepted formats, but it allows you to update or change it 
easily as need arises. You may also be in the business of preparing 
resumeés for others. If so, a resumé macro will save you valuable time 
and effort. 

There are several common formats of resumés. This chapter 
details the design and use of macros for the two most popular types: 


¢Skill-format resumés. 


¢Chronological-format resumés. 
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You will also learn how to enter boilerplate text into the resumé 
while the macro is executing. 


BUILDING SKILL-FORMAT RESUMES 


The skill-format resumé emphasizes achievement in past jobs or in 
school. It is most often used by job candidates with specific qualifica- 
tions which are suited for the desired position. The format makes it 
easy for employers to see a broad overview of what you believe your 
major skills are. The format can also be used to camouflage periods 
of unemployment or jobs you've had that didn’t promote your career 
plans. Good personnel directors know all the ins and outs of skill- 
format (also called functional, or achievement) resumés, so it’s best 
not to try to bury your past too much. 

The disadvantage of the skill-format resumé is that it is often hard 
to prepare, because it requires strict observation of style. The follow- 
ing macro allows you to build a skill-format resumé merely by “fill- 
ing in the blanks." What you enter into these blanks makes all the 
difference in the world, so take your time to consider your skills, 
digest them into actual achievements and accomplishments you 
have made, then start the macro. 

The skill-format resumé macro uses a simple template document 
named RESUME1.TMP. The template includes your name, address, 
and telephone number centered at the top of the page (see Figure 
13-1). These formatting codes were used with the prototype resumé 
macro: 

¢Widow/orphan control on—[Shift]-[F8], 1, 9, Y. 

¢Page numbering top center—[Shift]-[F8], 2, 7, 9. 

«Suppress page numbering this page only (affects first page only)— 

[Shift]-[F8], 2, 9, 4, Y. 

Add two or three blank lines below your name and address. 


RESUMELWPM (CHAP 18 directory on Applications Disk) 
1. (Retrieve}RESUME1.TMP(Enter} 
(Home) (Home) {Down} 
2. (Bold})JOB OBJECTIVE(Bold}(Enter} 
(Indent} 


(PROMPT) Enter job objective; press Ctrl-Enter when done. - -~ 
{CALL)Hpg~ 
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<Your Name Here? 
<Your Address Here> 
«City, State, ZIP> 


Day Phone: 123-4567 Evening Phone! 987-6543 


D: \UPS@\TEXT\RESUMEL. TMP Doc 1 Pg 1 Ln 1 Pos 18 
" DS TT -3 — : ° z ° } 


¢ Te REI, a. , ; 
MAAC Pg Numbering: Top CenterJ(Suppress:! PgNunJCBOLDIJCCntr)<Your Name Here>CC 
AYFIlrtJCHRt] 

COntrj]<Your Address Here>CC/A/FlrtICHRtI 

CCntri<City, State, ZIP>CboldICC“A/FirtJCHRt] 

CHRE] 

CCntrlDay Phone: 123[-14567 Evening Phone: 987C-J6543[C/A7/FlrtICHRE] 

CHRtI 

CHRtI 


Press Reveal Codes to restore screen 


FIGURE13-1 RESUME1.TMP TEMPLATE DOCUMENT, WITH CODES 


3. (Bold SUMMARY (Bold) {Enter} 
(Indent) 
(PROMPT)Enter skills summary; press Ctrl-Enter when 
done. - -~ 
(CALL)Hpg~ 
4. {Bold}PROFESSIONAL SKILLS(Bold) (Enter) 
(Indent} 
(PROMPT})Enter professional skills; press Ctrl- Enter when 
done. ~ 
(CALL) Hpg~ 
5. (Bold, WORK EXPERIENCE(Bold) (Enter) 
{Indent) 
(PROMPT}Enter work experience; press Ctrl-Enter when 
done. - -~ 
(CALL)Hpg~ 
6. (Bold)EDUCATION (Bold) (Enter) 
(Indent) 
(PROMPT)Enter education; press Ctrl-Enter when done. - ~ 
(CALL) Hpg~ 
7. (Bold, PROFESSIONAL MEMBERSHIPS (Bold) (Enter) 
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(Indent} 
(PROMPT}Enter professional memberships; press Ctrl-Enter 
when done. - -~ 
(CALL) Hpg~ 
8. (Bold PERSONAL DATA(Bold) (Enter) 
{Indent} 
(PROMPT) Enter personal data; press Ctrl-Enter when done. «~ 
(CALL)Hpg~ 
(QUIT) 
9. (LABEL) Hpg~ 
(ASSIGN}0~~ 
{LABEL} loop~ 
{(LOOK}0~ 
{IF)"{VAR 0)"="{HPg)}"~ (Enter) (Enter} (RETURN} 
{ELSE) (VAR 0) 
{IF)" (VAR 0)"="{Enter)"~(Enter) (Indent}(GO}loop~ 
(ELSE) {GO)loop~ 
(END IF){END IF) 


‘Step 1 retrieves RESUME1.TMP and moves the cursor to the end 
of the file. 


Step 2 prints JOB OBJECTIVE on the resumé and adds "Enter 
job objective; press Ctrl-Enter when done”. The macro then jumps 
to the "Hpg" subroutine, detailed below. 


¢Steps 3 through 8 repeat the process for the other resumé head- 
ings. 


¢Step 9 is the "Hpg" subroutine. It checks to see if you have pressed 
either [Ctrl]-[Enter] (a hard page break) or [Enter]. As long as 
these keys aren’t pressed, the subroutine loops back on itself. 
When you press [Enter], the macro adds an [HRt] and [Indent] 
code to the resumé (one space and one indent). When you press 
[Ctrlj-[Enter], the macro adds two [HRt] codes to the resumé 
(double space), then returns to the point it left off before calling 
the subroutine. 


Note that the macro does not pass the actual keystrokes of the 
[Ctrl]-[Enter] or [Enter] keys to the resumé, but are trapped in 
the macro subroutine. The subroutine acts to redefine the [Ctrl]- 
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[Enter] and [Enter] keys temporarily and produce the effects 
described. 

An example of a completed resumé is shown in Figure 13-2. The 
macro automatically double-spaces between categories and indents 
at every line. 

If you don’t want the paragraphs indented, use the macro that fol- 
lows instead. It is nearly identical to RESUME1.WPM except for the 
following: 


oIt does not indent paragraphs. 


oIt lets you add dashes to the beginning of paragraphs in unnum- 
bered lists (you can substitute other characters for the dashes if 
you wish). 


°It inhibits the [Cancel] key so you can use it to restore acciden- 
tally erased text. Normally, pressing [Cancel] stops macro execu- 
tion or disrupts the operation of subroutines within a macro. 


elt adds an "Exit" feature that lets you signal the end of the resumé 
(you can use "Exit" at any time). To stop, press [F7]. The macro 
traps the [F7] key so that it triggers a special print-and-spell 
routine, and doesn’t signal that you want to leave the document. 


°The WordPerfect Speller module should be installed on your hard 
disk (or be readily available if you are using floppy disks). 


RESUME2.WPM (CHAP18 directory on Applications Disk) 

1. (CANCEL OFF) 
(Retrieve)RESUME1.TMP(Enter) 
(Home) {Home}(Down) 

2. (Bold)JOB OBJECTIVE(Bold) (Enter) 
(PROMPT)Enter job objective; press Ctrl-Enter when done. «~ 
(CALL) Hpg~ 

3. {Bold} SUMMARY (Bold) (Enter) 
(PROMPT)Enter skills summary; press Ctrl-Enter when 
done. - -~ 
(CALL)Hpg~ 

4, (Bold) PROFESSIONAL SKILLS({Bold) (Enter) 
(PROMPT)Enter professional skills; press Ctrl- Enter when 
done. ~ 
(CALL) Hpg~ 

5. (Bold) WORK EXPERIENCE (Bold) (Enter) 
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<Your Name Here> 
<Your Address Here> 
<City, State, ZIP> 


Day Phone: 123-4567 Evening Phone: 987-6543 


JOB OBJECTIVE 
A corporate training and management position. 
SUMMARY 


Over 14 years of on-the-job corporate management training, 


coupled with seven years experience with clerical and 
manufacturing training. 


PROFESSIONAL SKILLS 


Corporate Training -- Trained low- and mid-management ~ 
personnel, with emphasis on written and oral communications. 


Clerical Training -- Developed a comprehensive administrative 
personnel training program, which included two-day seminars on 
typing, shorthand, and computer literacy. 


Manufacturing Training -- Established company-wide training 


program for manufacturing personnel, as an effort to streamline 
company operations. 


WORK EXPERIENCE 


Training Specialiast: Midland Bolt and Screw Company, Midland, 
Ohio (1975-present). 


Training Coordinator: Robertson Clock Works, Galvaston, Texas 
(1971-1975) 


Assistant Director of Human Resources: Henderson Trucking, 
Galvaston, Texas (1970-1071). 


EDUCATION 
University of California at Santa Cruz, M.S. Educational 
Administration, Business Law, 1969 
Palomar Junior College, San Marcos, CA, General Courses, 1968 


PROFESSIONAL MEMBERSHIPS 
American Society for Training and Development 


American Society for Personnel Administration 


PERSONAL DATA 
References available on request. 


Willing to relocate. 


FIGURE13-2 SAMPLE RESUME1.WPM RESUME 
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(PROMPT)Enter work experience; press Ctrl-Enter when 
done. : -~ 

(CALL) Hpg~ 

6. (Bold EDUCATION (Bold) {Enter} 
(PROMPT}Enter education; press Ctrl-Enter when done. » -~ 
(CALL) Hpg~ 

7. (Bold PROFESSIONAL MEMBERSHIPS (Bold) (Enter) 
(PROMPT)Enter professional memberships; press Ctrl-Enter 
when done. - -~ 
(CALL) Hpg~ 

8. (Bold) PERSONAL DATA(Bold) (Enter) 
(PROMPT)Enter personal data; press Ctrl-Enter when 
done. - :~ 
(CALL) Hpg~ 
(GO) finish~ 

9. {LABEL)Hpg~ 
(ASSIGN) 0~~ 
(LABEL) loop~ 
(LOOK) 0~ 
(IF)"(VAR 0)"="(HPg")~ (Enter) (Enter) (RETURN) 
{ELSE} 
(IF}"(VAR 0)}"="(Exit)"~(QUIT) 
(ELSE) 
(IF}" (VAR 0)"="(Enter}"~{Enter) (Enter) (GO}loop~ 
(ELSE) 
(IF)"(VAR 0)"="(^N})"~(Indent)--(Indent})(GO})loop 
(ELSE) (VAR 0}(GO)loop~ 
(END IF){END IF)(END IF) (END IF} 

10. ({LABEL)finish~ 

{Home) (Home) {Up} 
(Spell)3 
(QUIT) 


¢Step i retrieves RESUME1.TMP and moves the cursor to the end 
of the file. 

eStep 2 prints JOB OBJECTIVE on the resumé and adds "Enter 
job objective; press Ctrl-Enter when done." The macro then jumps 
to the "Hpg" subroutine, detailed below. 


eSteps 3 through 8 repeat the process for the other resumé head- 
ings. 
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*Step 9 is the "Hpg" subroutine. The subroutine checks for you to 
press [Enter], (Ctrl]-[Enter], [Ctrl]-N, or [F7]. The macro per- 
forms the action immediately following the IF statement. 


¢Step 10 brings the cursor to the beginning and initiates a docu- 
ment-wide spell check. You may, if you wish, delete the (Spell}3 
instruction. 


An example of a finished resumé using the RESUME2 macro is 
shown in Figure 13-3. 


BUILDING CHRONOLOGICAL-FORMAT 
RESUMES 


A chronological-format resumé lists your educational or employment 
history, typically starting with the most recent school or job first, 
then working back a reasonable period of time depending on your 
background, age, and the nature of the position you are applying for. 


The chronological format is the most widely used and therefore 
the most familiar resumé format to employers. The format is 
reasonably easy to prepare because you are simply retelling your 
personal history. The format is ideally suited if you have stayed in 
one career for most of your professional life, or have an outstanding 
track record with a small handful of previous employers. Its disad- 
vantages are that it is difficult for you to highlight specific jobs and 
achievements and makes interruptions in your educational or voca- 
tional record very obvious. 

The macro for building the chronological-format resumé is a com- 
posite between RESUME1.WPM and RESUME2.WPM, above, but 
the biggest difference is that the categories and prompts have been 
changed. This macro also lacks the {CANCEL OFF) instruction at 
the beginning, although you can add it if you'd like. 


RESUME3.WPM (CHAP13 directory on Applications Disk) 
1. (Retrieve)RESUME1.TMP(Enter} 
(Home} {Home} (Down) 
2. (BoldJPROFESSIONAL EDUCATION (Bold) (Enter) (Enter) 
({Indent} 


{(PROMPT}Enter professional education; press Ctrl- Enter when 
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<Your Name Here> 
<Your Address Here> 
<City, State, ZIP> 


Day Phone: 123-4567 Evening Phone: 987-6543 


JOB OBJECTIVE 
A corporate training and management position. 


SUMMARY 
Over 14 years of on-the-job corporate management training, 
coupled with seven years experience with clerical and 
manufacturing training. 


PROFESSIONAL SKILLS 
-- Corporate Training ~~ Trained low- and mid-management 
personnel, with emphasis on written and oral communications. 


-- Clerical Training -- Developed a comprehensive 
administrative personnel training program, which included 
two-day seminars on typing, shorthand, and computer 
literacy. 


-- Manufacturing Training -- Established company-wide training 
program for manufacturing personnel, as an effort to 
streamline company operations. 

WORK EXPERIENCE 

-- Training Specialiast: Midland Bolt and Screw Company, 

Midland, Ohio (1975-present). 


-- Training Coordinator: Robertson Clock Works, Galvaston, 
Texas (1971-1975) 


-~ Assistant Director of Human Resources: Henderson Trucking, 
Galvaston, Texas (1970-1071). 


EDUCATION 
-- University of California at Santa Cruz, M.S. Educational 
Administration, Business Law, 1969 


-- Palomar Junior College, San Marcos, CA, General Courses, 
1968 


PROFESSIONAL MEMBERSHIPS 
American Society for Training and Development 


American Society for Personnel Administration 


PERSONAL DATA 
References available on request. 


Willing to relocate. 


FIGURE138-8 SAMPLE RESUME2.WPM RESUME 
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done. ~ 
(CALL) Hpg~ 
3. (Bold UNDERGRADUATE EDUCATION (Bold) (Enter) (Enter) 
(Indent) 
(PROMPT) Enter undergraduate education; press Ctrl- Enter 
when done. - -~ 
(CALL)Hpg~ 
4, (Bold. EMPLOYMENT (Bold) (Enter) {Enter} 
(Indent) 
(PROMPT) Enter employment history; press Ctrl- Enter when 
done. . -~ 
(CALL)Hpg~ 
5. (Bold. REFERENCES (Bold) (Enter) (Enter) 


(PROMPT)Enter work experience; press Ctrl-Enter when 
done. - -~ 


(CALL)Hpg~ 
(GO)finish~ 
6. (LABEL) Hpg~ 
(ASSIGN) 0~~ 
(LABEL) loop~ 
(LOOK)}0~ 
([F)"(VAR 0)"="(HPe"}~ (Enter) (Enter) (RETURN} 
(ELSE) 
IF)" (VAR 0)"="{Exit}"~(QUIT) 
(ELSE) 
(IF}"(VAR 0)"="{Enter)"~{Enter (Indent) {(GO)loop~ 
(ELSE) (VAR 0) (GO)loop~ 
(END IF) (END IF)(END IF} 
7. (LABEL)finish~ (Home) {Home} (Up) 
(Spellj3 
(QUIT) 


An example of a resumé created with RESUME3.WPM macro is 
illustrated in Figure 13—4. The organization of the prompts assume 
you want to emphasize your education over employment. If your job 
history is your strong suit, put it first. 

Since most people prefer to write "References available upon re- 
quest” under the REFERENCES heading, you may want to enter 


that text automatically, with the macro. Change Step 8 so that it al- 
Ways prints out: 
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<Your Name Hera> 
<Your Address Here> 
<City, State, ZIP> 


Day Phone: 123~4567 Evening Phone: 987-6543 


PROFESSIONAL EDUCATION 


University of California at Santa Cruz, Santa Cruz, CA 
M.S.: Educational Administration, 1969 

Minor: Business Law 

Graduated with Honors 

Awards: Recipient of Young Adult Business Award 


UNDERGRADUATE EDUCATION 


Palomar Junior College, San Marcos, CA 
General Courses, 1968 


EMPLOYMENT 
Training Specialiast 
Midland Bolt and Screw Company, Midland, Ohio 
(1975-present). 
Training Coordinator 
Robertson Clock Works, Galvaston, Texas 
(1971-1975) 
Assistant Director of Human Resources 
Henderson Trucking, Galvaston, Texas 
(1970-1071). 

REFERENCES 


Available upon request. 


FIGURE 18-4 SAMPLE RESUME3.WPM RESUME 
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REFERENCES 
References available upon request. 


Remove the prompt so the macro no longer stops at the REFEREN- 
CES heading. 


COMPLETE ENTRY RESUMES 


The three resumé macros presented so far in this chapter have used 
the same RESUME1.TMP template document. This document in- 
cludes your name, address, and telephone number, as well as codes 
for formatting the document. The macro that appears below does 
everything, including setting the formats and asking for a name, ad- 
dress, and telephone number. The macro uses the chronological-for- 
mat resumé style described for the RESUME3.WPM macro. You can 
easily modify it so that it produces resumés using other formats. 


RESUME4.WPM (CHAP183 directory on Applications Disk) 
1. (CANCEL OFF) 
(DISPLAY OFF) 
(Format) 19y{Enter)} 
27294y(Enter) (Enter) {Enter} 
(DISPLAY ON} 
2. (Bold) (Center) 
(PROMPT)Enter name, press Enter when done. - -~ 
(CALL) waitenter~ 
3. (Center) 
(PROMPT)Enter street address; press Enter when done. : -~ 
(CALL) waitenter~ 
4. {Center) 
(PROMPT)Enter city, state, and ZIP; press Enter when 
done. - -~ 
(CALL) waitenter~ 
D. (Bold) {Center} 
(PROMPT)Enter telephone number(s); press Enter when 
done. - «~ 
(CALL) waitenter~ 
(Enter) (Enter) 


. {Bold)PROFESSIONAL EDUCATION (Bold) {Enter} (Enter) 


o) 


T; 


8. 


9. 


10. 


11. 


12. 
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(Indent) 

(PROMPT)Enter professional education; press Ctrl-Enter 
when done. : -~ 

(CALL)Hpg~ 

(Bold UNDERGRADUATE EDUCATION (Bold) (Enter) (Enter) 

(Indent) 

(PROMPT)Enter undergraduate education; press Ctrl- Enter 

when done. -~ 

(CALL) Hpg- 

(Bold EMPLOYMENT (Bold) (Enter) (Enter) 

(Indent) 

(PROMPT)Enter employment history; press Ctrl- Enter when 

done. -~ 

(CALL)Hpg~ 

(Bold)REFERENCES(Bold) (Enter) (Enter) 

(PROMPT) Enter work experience; press Ctrl-Enter when 

done. -~ 

(CALL) Hpg~ 

(GO) finish~ 

(LABEL) Hpg~ 

(ASSIGN) 0~~ 

{LABEL} loop~ 

{LOOK)0~ 

(IF)"(VAR 0)"="(HPg")~ (Enter) (Enter) {RETURN} 

(ELSE) 

(IF)"(VAR 0)"="(Exit)"~(QUIT) 

(ELSE) 

(IF)" (VAR 0}"="(Enter)"~(Enter) (Indent) {GO}loop~ 

(ELSE) (VAR 0) (GO)loop~ 

{END IF) (END IF) (END IF) 

(LABEL) waitenter~ 

{ASSIGN} 0~~ 

(LABEL)loop1~ 

(VAR 0) 

(LOOK) 0~ 

(IF)"(VAR 0)"="(Enter}"~(Enter}) (RETURN) 

{ELSE) (GO) loop1~ 

(LABEL) finish~ 

(Home) {Home) {Up} 

(Spell}3 

(QUIT) 
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¢Step 1 inhibits use of the [Cancel] key and turns the display off. 
The macro then steps up the formatting for the document (format- 
ting is the same as the RESUME1.TMP template document). At 
the end of the step, WordPerfect turns the display back on. 


Step 2 asks for your name. It is entered in the resumé document 
as centered, bold text. Steps 3 and 4 repeat the process for street 
address and name, city, and ZIP code. 


*Step 5 asks for your telephone number. It is entered in the resumé 
document as centered text. Once you’ve provided the phone num- 
ber, the macro adds two blank lines and proceeds with the resumé 
headings (see RESUME3.WPM for a description of the operation 
of the category/prompt and "Hpg" subroutine steps). 


¢Step 11 is the "waitenter" subroutine. It waits for you to press the 


[Enter] key after typing the name, address, and phone number 
before continuing with the macro. 


¢Step 12 is the "finish" routine that brings the cursor to the begin- 
ning of the document and initiates a spell check. 


FIGURE13-5 SAMPLE MENU SYSTEM FOR RESUMES 


<Your Name Here> 
<Your Address Here> 
«City, State, ZIP> 


Day Phone: 123-4567 Evening Phone: 387-6543 


JOB OBJECTIVE 


A management position that offers a challenge and provides 
grouth potential. 


SUMMARY 


Emphasize: 
1 Computer Experiences: 

Z Management Experience: 

3 Training Experience; 

4 Both Management and Training Experience __ 
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ENTERING BOILERPLATE TEXT WHILE 
BUILDING A RESUME 


If you are plan on sending custom-made resumés to various 
employers, you'll find it easier if you store common resumé entries 
as text-only macros (macros that contain only text and no format- 
ting codes). For example, your text-only macros might have one or 
two variations of your job objective, skills summary, or work ex- 
perience. Or you might keep your educational background, which 
stays the same for most resumés, in a text-only macro for easy recall. 
You must store the text as Alt-letter macros. 

To use the system of resumé macros, start the main macro 
(RESUME1.WPM through RESUME4.WPM), then, instead of 
typing text directly from the keyboard, invoke one of the macros. If 
you're creating a lot of versions of your resumé for employers, you 
may want to use one of the menu systems outlined in Chapter Five. 
That way, you can pick the macros to use from an on-screen list, such 
as that illustrated in Figure 13-5. Each segment of the resumé calls 
up a different menu. 


CHAPTER 14 
MANUSCRIPT 


PREPARATION 


A, a writer, I frequently use over two dozen macros in the prepara- 
tion of my manuscripts. Though many are small and simple, with 
but a single purpose, their overall effect is tremendous. With my 
regular stable of macros, I save a great deal of time and effort over 
the old manual methods of manuscript preparation. 

If you prepare manuscripts of any type or size, either for yourself 
or someone else, you’!l want to check out the macros, templates, and 
styles in this chapter. You'll find plans for: 


e Line spacing macros. 
¢Macros for building headers and footers. 
¢Macros for footnotes and endnotes. 
e Macros for writing outlines. 
e Hollywood-style script formats. 
¢Macros for building a table of contents and index. 
¢Macros for editing text. 
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e Macros for document conversion. 


LINE SPACING FORMATS 


Probably the most basic formatting macro you may ever write is to 
change the line spacing inside your document. WordPerfect requires 
that you press seven keys just to change the line spacing from 1 to 
2. If you are preparing a manuscript with many line space changes, 
that’s a lot of added keystrokes and lost time. The following macros 
change the existing line spacing to single, one and a half, and double. 
The macros are given full text names but you may wish to rename 


them to [Alt]-letter key combinations so that they can be more easi- 
ly retrieved. 


To Set Single-space 


SINGLE.WPM (CHAP14 directory on Applications Disk) 


Key Sequence What it Does 
1. (Ctrl]-[F10] Starts macro definition. 
2. single Names macro "SINGLE.WPM." 
[Enter] 
3. Single space Describes macro. 
[Enter] 
4. (Shift]-[F8] Chooses Format menu. 
0.16 Selects Line and Space options. 
6. 1 Sets spacing to 1. 
7. [Enter] [Enter] Exits Format menu. 
[Enter] 
8. [Ctrl]-[F10] Ends macro definition. 


To Set One-and-a-Half-Space 


ONEHALF.WPM (CHAP14 directory on Applications Disk) 


Key Sequence What it Does 
1. (Ctrl]-[F10] Starts macro definition. 
2. onehalf Names macro "ONEHALF.WPM." 


[Enter] 


To Set Double-space 


IAD 


. One and a half 


spacing 
[Enter] 


. (Shift]-[F8] 


16 
1.5 


. [Enter] [Enter] 


[Enter] 


. [Ctrl]-[F 10] 
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Describes macro. 


Chooses Format menu. 

Selects Line and Space options. 
Sets spacing to 1.5. 

Exits Format menu. 


Ends macro definition. 


DOUBLE.WPM (CHAP14 directory on Applications Disk) 
Key Sequence 


1. 
. double 


CO 


IA OB 


(Ctrl]-[F10] 


[Enter] 


. Double space 


[Enter] 


. [Shift]-[F8] 


16 
2 


. [Enter] [Enter] 


[Enter] 


. (Ctrl]-[F10] 


Open Space 


What it Does 
Starts macro definition. 
Names macro "DOUBLE.WPM." 


Describes macro. 

Chooses Format menu. 

Selects Line and Space options. 
Sets spacing to 1. 


Exits Format menu. 


Ends macro definition. 


Many manuscript formats require open spaces between paragraphs 
or certain other blocks of text. The open space is an extra line or two 
between adjacent paragraphs. For example, you might want a for- 
mat where the lines within the paragraph are double-spaced, but the 
lines between the paragraphs are triple-spaced. You can change 
spacing between paragraphs (or other text blocks) with either a 
macro or a Style. The macro is invoked manually each time you want 
the open space, or the macro can automatically add the extra space 
for each paragraph. 
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Manual Open Space Macro—The manual open space macro simp- 
ly changes the line spacing, adds the number of extra lines you want, 
then changes the line spacing back to normal. Here’s a macro that 
puts an extra blank line between double-spaced paragraphs (assume 


that the current line spacing format is already 2 when the macro is 
invoked): 


OPENLWPM (CHAP14 directory on Applications Disk) 


Key Sequence What it Does 
1. [Ctrl]-[F10] Starts macro definition. 
2. OPENI Names macro. 
3. Extra line with Describes macro. 
double-space 
[Enter] 
4.{ Shift]-[F8] Chooses Format menu. 
5.1 6 Selects Line and Space options. 
6.1 Sets spacing to 1. 
7. [Enter] [Enter] Exits Format menu. 
[Enter] 
8. [Enter] Adds extra line. 
9. [Shift]-[F8] Chooses Format menu. 
10.16 Selects Line and Space options. 
11. 2 Sets spacing back to 2. 
12. [Enter] [Enter] Exits Format menu. 
[Enter] 
13. (Ctrl]-[F10] Ends macro definition. 


The effect of the open space using this macro is shown in Figure 
14-1. You can use this macro to add an extra blank space between 
paragraphs of text blocks regardless of the current line-spacing for- 
mat, but you should change the line spacing in Step 12 accordingly. 
Remember to press the [Enter] key at the end of each paragraph 


before invoking the macro. You can use this macro before or after 
the text is written. 


Automatic Open Space Macro—This macro automatically inserts 
the open space each time you press the [Enter] key. Run the macro 
at the beginning of the document. To cancel the macro and revert to 
regular spacing between paragraphs, press [F1]. This macro is effec- 
tive only when you are writing text. As shown, the macro resets the 
line spacing to 2 for the text that follows. Rewrite the macro as 
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<Your Name Here> 
<Your Address Here? 
«City, State, ZIP> 


Day Phone: 123-4567 Evening Phone: 987-6543 


JOB OBJECTIVE 
A management position that offers a challenge and provides 
growth potential. 


SUMMARY 


Emphasize: 
Computer Experience; 
Z Management Experience; 
3 Training Experience: 
4 Both Management and Training Experience_ 


FIGURE14-1 EFFECT OF OPEN SPACE 


needed when using different line spacings. You may wish to create 
a macro for all the common line spacings you use. Give each macro 
a unique name, such as AUTOSP1 (for auto-space, one- space), 
AUTOSP2, etc. 


AUTOSP2.WPM (CHAP14 directory on Applications Disk) 
(ASSIGN) 2~~ 
(LABEL) loop~ 
(VAR 2) 
{LOOK} 2~ 
(IF)"(VAR 2}"="(Enter}"~ 
{ELSE} {GO)loop~ 
(END IF) 
{DISPLAY OFF) 
{(Format)161 
(Enter) (Enter} (Enter) (Enter) 
{Format}162 
(Enter) {Enter} {Enter} 
(DISPLAY ON) 
{GO} loop~ 


326 WordPerfect 5.0 Macros and Templates 


Open Space Style -The disadvantage of the automatic open space 
macro is that you cannot run another macro over it. Not so with 
styles. Styles are independent of macros, and when used for chang- 
ing formats, are often just as useful. The following style uses the 
Enter key option to turn the style off, then back on every time you 
hit the [Enter] key. 

Create a style following the definition shown in Figure 14-2. To 
set the Off/On Enter key option, press 5, then 8. The style definition 
codes tell WordPerfect to: 


eStart with double-spacing. 


¢When the [Enter] key is pressed, switch to single spacing. 
e Add three empty lines. 


Because you choose the Off/On option, the style will restart itself 
and go back to double spacing. Change the style definition codes as 
required if you are using other line spacing. To set the codes as 


FIGURE14-2 STYLE DEFINITION FOR AUTO SPACE 


_—_——— a pr, 


and Style Off Codes below. 


Press Exit when done Doc 1 Pg 1 Ln 1 Pos 10 


fin Stacing: AE [Ln Spacing: 1] CHRtI 


CHRE 
CHRtI 
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shown in Figure 14-2, type the following in the style definition win- 
dow: 


OPENSP.STY (CHAP14 directory on Applications Disk) 


Key Sequence What it Does 

1. (Shift]-[F8] Selects Format menu. 

2.162 Chooses spacing of 2. 

3. [Enter] [Enter] Returns to style definition window. 
[Enter] 

4. [Right] Skips cursor over [Comment] code. 

5. (Shift]-[F8] Selects Format menu. 

6.161 Chooses spacing of 1. 

7. [Enter] [Enter] Returns to style definition window. 
[Enter] 

8. [Enter] [Enter] Enters three hard returns. 
[Enter] 


HEADERS AND FOOTERS 


By now, you probably know that a header is text that repeats on at 
the top of every page and that a footer is text that repeats at the bot- 
tom of every page. WordPerfect further allows you to define any 
number of headers or footers per document (you can easily switch 
between two predefined headers/footers), and apply them to every 
page, or every odd or even page. 

If you are a regular user of headers or footers, you'll find this col- 
lection of macros useful for automatically defining them, turning 
them on and off, and more. 


Defining a New Header or Footer 


HEADER.WPM nearly automates the steps of defining a new 
header. Executing the macro tells WordPerfect you want to define a 
new header. The macro pauses to let you enter the definition of the 
header in the header definition window. The moment you press [F7] 
to exit, the remainder of the macro starts and brings you all the way 
back to the document. The code for the newly defined header is 
automatically inserted in the text. 
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HEADER.WPM (CHAP14 directory on Applications Disk) 
1. (DISPLAY OFF) 
2. (Format)2 
3.3 
4,1 
5. 2 
(DISPLAY ON} 
6. (ASSIGN) 0~~ 
{LABEL}loop~ 
(VAR 0) 
(LOOK)0~ 
(IF}" (VAR 0}"="(Exit}"~ 
(DISPLAY OFF) (Exit) (Enter) (Enter) (DISPLAY ON} 
(ELSE) (GO) loop~ 
(END IF} 


¢Step 1 turns the display off. 

¢Step 2 selects the Format menu and chooses the Page option. 
Step 3 selects the Header Option. 

Step 4 selects the "A" header option. 

*Step 5 selects the Every Page option, then turns the display on. 


¢Step 6 waits for you to press [F7]. All other keystrokes are passed 
through to WordPerfect. When you press [F7], the macro exits the 
header definition window and returns to the main document. 


You can use the macro as a basis for defining new footers, as well. 
You may define header/footer "B" instead of "A," and choose to apply 
it to every page, odd pages, or even pages. 


To define a new footer, press 4 in Step 3. 

¢Set define header/footer "B," press 2 in Step 4. 

eTo apply header/footer to odd pages only, press 3 in Step 5. 
eTo apply header/footer to even pages only, press 4 in Step 5. 
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Turning a Header or Footer Off 


The next macro turns a header or footer off. This example is written 
for Header A; rewrite it to turn Header B or Footer A/B off. You can 
create this macro from the keyboard, as shown here, or from inside 
the macro editing window. 


OFFAHEAD.WPM (CHAP14 directory on Applications Disk) 


Key Sequence What it Does 

1. [Ctrl] -[F10] Starts macro definition. 

2. offahead Names macro "OFFAHEAD.WPM," 
[Enter] for header A off. 

3. Turn header A off Describes macro. 
[Enter] 

4. [Shift]-[F8] Chooses Format menu. 

5.231 Selects Page, Header, and Header 

A options. 

6. 1 Selects Discontinue option. 

7. [Enter] [Enter] Returns to document. 

8. [Ctrl]-[F10] Ends macro definition. 


Note that this macro, when used, turns the A header off after it 
has been on. WordPerfect applies a header to the current page as 
long as there is at least one character (such as a hard return) be- 
tween the header on and off codes. 


Suppressing a Header or Footer 


Sometimes, you may want to turn a header or footer off for a single 
page, and not worry about turning it back on after the page is over. 
Here are four macros, one each for Header A/B and Footer A/B, for 
doing the job quickly and easily. (They can be found in the CHAP14 
directory on the Applications Disk.) 


SUPAHEAD.WPM—Suppress Header A 
{DISPLAY OFF) 
{(Format)295y({Enter) 
{Enter} (Enter) 
(DISPLAY ON} 
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SUPBHEAD.WPM—Suppress Header B 
(DISPLAY OFF) 
(Format)296y (Enter) 
(Enter}{Enter) 
(DISPLAY ON) 


SUPAFOOT.WPM—Suppress Footer A 
(DISPLAY OFF) 
(Format}297y (Enter) 
(Enter) {Enter} 
(DISPLAY ON) 


SUPBFOOT.WPM—Suppress Footer B 
(DISPLAY OFF) 
(Format)298y (Enter) 
(Enter) (Enter) 
(DISPLAY ON) 


Constructing Header/Footer Libraries 


If you use it often enough, you may want to save the definition for a 
header or footer once you have created it. You can save the defini- 
tion as a macro, style, or document. 


eTo save a header or footer as a macro, start a new macro and go 
through all the steps of defining the header/footer. 


eTo save a header or footer as a style, embed the header/footer code 
in an Open style definition. 


eTo save a header or footer as a document, create the definition for 
the header/footer in an empty document, then store the document 
on disk. Alternatively, block just the header or footer code (use 


Reveal Codes to see it), then append it to a new document using 
the Move command. 


To call up the header or footer, run the macro, choose the style, or 
retrieve the document. It’s that simple. For ease of use, develop a 


naming strategy so that you can readily identify the header and 
footer files on the disk. For instance: 
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°LETHEAD.WPM—Letterhead header macro (the .WPM exten- 
sion is automatic). 


°LETFOOT.WPM—Letterhead footer macro. 
°CORHEAD.STY—Corporate manuscript header style. 
oRNVFOOT.STY—Envelope printing footer style. 
eSCRIPT.HED—Script format header document. 
°SCRIPT.FOT—Script format footer document. 


Using Header and Footer Prefixes 


If you find that you mix and match the text for headers and footers— 
sometimes the text is for a header and sometimes it’s for a footer, 
you can construct a macro "prefix" that starts either a header or 
footer for the definition that follows. The definition itself contains 
only formats and text for the header or footer. Be sure to leave out 
the codes for actually starting a header/footer. The system works 
when storing headers and footers as macros, styles, or documents. 
The following example shows how it can be used with header macros: 


First, create the "prefix" macro. 


HEAD.WPM (CHAP14 directory on Applications Disk) 
(DISPLAY OFF) 
(Format})2312 
(TEXT}0~~ 
(CHAIN) {VAR 0)~ 


Next, create the actual header definition macro. This example 
prints "This is a test..." in the header. Call this macro TEST1. 


TEST1.WPM (CHAP14 directory on Applications Disk) 
This is a test... 
(Exit) (Enter) (Enter) 
(DISPLAY ON) 


To use the header prefix with the TEST header definition, press 
[Alt]-[F10] to call up a macro, then type HEAD. Instead of pressing 
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[Enter], just tap on the [Spacebar]. That does the same thing as 
pressing the [Enter] key—it starts macro execution—but is more 
intuitive when entering the prefix and definition macros. The 
HEAD.WPM prefix macro will run and stop at the (TEXT) instruc- 
tion. Since no message is displayed, the screen will remain blank. 
Now enter TEST1 as the definition macro you want to use. Press 
[Enter] when you are through and the header definition is complete. 

As shown, the HEAD.WPM macro starts a Header A definition and 
applies the header to every page. Because the TESTLWPM header 
macro contains only the actual definition of the header and not all 
the steps for creating the header from scratch, you can also use it to 
make a footer. The same is true if you wish to apply the TESTLWPM 
definition to Header or Footer B, and to apply the header/footer only 
to odd- or even-numbered pages. 


You can create other header/footer prefixes to suit your needs. 
Here are some examples. 


To define Footer A: 
(DISPLAY OFF} 
(Format)2412 
(TEXT)0~~ 
(CHAIN) (VAR 0}~ 
Name the macro FOOT.WPM. 


To define Footer B, on for even pages only: 
(DISPLAY OFF) 
(Format}2414 
(TEXT)0~~ 
(CHAIN) (VAR 0)~ 
Name the macro FOOTAEVN.WPM 


To define Head B, on for odd pages only: 
(DISPLAY OFF} 
(Format)2323 
(TEXT}0~~ 
(CHAIN) (VAR 0}~ 


Name the macro HEADBODD.WPM. 
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FOOTNOTES AND ENDNOTES 


WordPerfect provides many options for setting up footnotes and 
endnotes in documents. That means extra keystrokes to define even 
one footnote or endnote. If all you need to do is enter standard foot- 
notes and endnotes, these two macros will greatly speed up the 
process. 


Creating Footnotes and Endnotes 

Although the macros are called FOOTNOTE.WPM and AND 
ENDNOTE.WPM on the Applications Disk, for ease of use you 
should rename them with an [Alt]-letter key combination. 
FOOTNOTE.WPM (CHAP14 directory on Applications Disk) 


{Footnote}11 
(Tab) 


FIGURE 14-3 NOTES IN FOOTNOTE WINDOW 


1 Markles, John: Be a Supreme Court Judge — Or Just Look 
Like One, Atherton Press International, 19383 


Press Exit when done Doc 1 Pg 1 Ln 5 Pos 18 


334 WordPerfect 5.0 Macros and Templates 


ENDNOTE.WPM (CHAP14 directory on Applications Disk) 
(Footnote)21 
(Tab) 


When the macros finish, you are left in the footnote/endnote edit- 
ing window, as depicted in Figure 14—3. Write the note and press 
[F7] to go back to the document. 


Restarting Footnote/Endnote Numbering 


When stringing many documents together into a book or article 
series, it’s often desirable to continue the endnote and footnote num- 
bering of previous documents. WordPerfect allows you to start note 
numbering at any point. These two macros eliminate a few of the 
keystrokes. After executing the macro, enter the new note number 
and press [Enter]. 


FOOTNUM.WPM (CHAP14 directory on Applications Disk) 
(Footnote) 
13 


(Footnote) 
Setting Script Formats Using Macros 


You may specify any place in your document for endnotes. When 
WordPerfect encounters the endnote placement code, [Endnote 
Placement], it unloads all of the endnotes it has accumulated since 
the beginning of the document or since the last endnote placement 
code. Here’s a macro that not only places the code but forces Word- 
Perfect to calculate the amount of space needed for the endnotes. 


ENDPLACE.WPM (CHAP14 directory on Applications Disk) 
{Footnote}3n 


(Mark Text) 65y 
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Footnote Options 


1 Spacing Within Footnotes 
Betvueen Footnotes 0.16” 


Amount of Note to Keep Together 0, 5” 

Style for Number in Text [SUPRSCPT]CNote Num) Csuprscpt] 
Style for Number in Note CSUPRSCPTICNote NumJ]Csuprscp 
Footnote Numbering Method Numbers 

Start Footnote Numbers each Page No 

Line Separating Text and Footnotes 2Z-inch Line 

Print Continued Mesecage No 


Footnotes at Bottom of Page Yes 


Selection: @ 


FIGURE14—4 NOTE OPTIONS MENU 


Building Elaborate Footnote and Endnote Styles 


WordPerfect allows you to control just about every aspect of the ap- 
pearance of footnotes and endnotes. The Footnote/Endnote Options 
menu, as shown in Figure 14—4, allows you to change, among other 
things, the style for the note number in the text and in the note, the 
line separator between text and notes, the placement of footnotes on 
the page, and more. 

While you could encode these Option settings in a macro, a better 
place is in a style that you insert at the top of the document, or 
wherever you want to specify formats for the footnotes and endnotes. 
If you regularly use the style, include it in the Style Library so that 
every new WordPerfect document has easy access to it. 


MACROS FOR WRITING OUTLINES 


WordPerfect’s outline feature is fine if you produce only occasional 
outlines. Just turn outlining on and type away. WordPerfect 
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automatically turns paragraph numbering on for you. The number 


of times you press the [Tab] key determines the level of the outline 
entry. For example, 


1. First Level. (no tabs) 
A. Second Level (one tab) 
1. Third Level (two tabs) 


a. Fourth Level (three tabs) 


The WordPerfect outliner is severely limited if you are a regular 
outline writer, because it requires you to press a series of keys just 
to set up the proper formatting. Entering each outline level requires 
you to go through the following steps: 


¢Press [Enter] to start a new line. 
Press [Tab] one or more times to set the outline level. 


¢Press [F4] (Indent) to indent the text away from the paragraph 
number or level. 


FIGURE14-5 COMPLEX OUTLINE 


1. 


Z. Efforts of Business Development 
a. Film industry. 
b. Record industry. 
C; Publishing industry. 
i. Booka 
(1) Trade 
(Z) Paperback 
(3) Technical 
11. Magazines 
(1) General circulation 
(Z) Subscription 
Cad Paid 
(b) Controlled audit 
111. Greeting cards_ 
Outline 


Opening Remarks 
a. Introduction to the session. 
L. Welcome. 


1i. Last minute updates. 
b. Introduction to panel members. 
A. L. Bean, 


ii. U. Markham. 
iii. B. Travis 
iv. 0. R. Lu 


Doc 1 Pg 1 Ln 2 Pos 39 
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No matter what level the previous line was at, you still must press 
[Tab] the specified number of times to set the outline level for the 
next line. That can be a real hassle if your outlines regularly use 
three or more levels. As an example, the outline shown in Figure 14— 
5 took almost five minutes to write; a good portion of that time was 
pressing the right keys to insure proper formatting. With the macros 
presented in this section, you can cut outline preparation time by 50 
percent or more 


Basic Outline Macro 


How about a macro that maintains the right formatting and keeps 
track of the outline level of the previous line and 

reapplies it to the current line? OUTLINE.WPM, shown below, 
turns the outliner on and applies most of the proper formats 
automatically. It also redefines the [Tab] key so that it can be used 
to indent the line of text rather than set a new outline level. The 
redefinition makes using the outliner easier for people who are used 
to indenting lines with the [Tab] key and not [F4], the [Indent] key. 


The macro also redefines a number of other keys: 


o Pressing [F7] (Exit) stops the macro. 
e Pressing [Ctrl]-[Right] steps forward one outline level. 


e Pressing [Enter] starts a new line, and indents to the previous 
outline level. 


°Pressing [Ctrl]-[Left] steps back one outline level. 


To use the macro, press Enter to start each new line. Press [Ctrl]- 
[Right] to demote a topic to next lower level. (Press [Ctrl]-[Right] 
before writing the text for that line.)Press [Ctrl]-[Left] to promote 
a topic to the next higher level. (Press [Ctrl]-[Left] before writing 
the text for that line.) | 


OUTLINE.WPM (CHAP14 directory on Applications Disk) 
1. (DISPLAY OFF) 
{(Date/Outline)62{Enter) 
4{Enter} 
(Indent) 
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(DISPLAY ON} 
2. (ASSIGN) 0~-~ 
(ASSIGN) 1~0~ 
(LABEL) loop~ 
(LOOK}0~ 
3. (IF}"(VAR 0}"="(Tab})"~ (Indent) (GO) loop~ 
(ELSE) 
4, (IF)"(VAR 0}"="(Exit}"~(QUIT} 
(ELSE) 
5. (IF)"(VAR 0}"="(Word Right)"~ 
{ASSIGN)1~{VAR 1)+1~ 
(Left) (Left) {Tab} (Right) (Right) 
(GOJ)loop~ 
(ELSE} 
6. (IF)"(VAR 0)"="(Enter}"~ 
(Enter) 
(Esc} {VAR 1) (T'ab} (Indent} 
(GO)loop~ 
(ELSE) 
7. {IF}"(VAR 0)"="(Word Left}"~ 
(ASSIGN) 1~(VAR 1)}-1~ 
(Left) (Left) (Backspace} (Right) (Right) 
(GO)}loop~ 
(ELSE) (VAR 0}{GO)loop~ 
{END IF) (END IF (END IF) {END IF {END IF) 


«Step 1 turns the display off and sets the outline numbering style 
to Paragraph (delete this step if you want the default outline num- 
bering style, or modify it if you choose another numbering style). 
At the end of the step, the macro turns outlining on and indents 
one tab stop. The display is turned on. 


«Step 2 sets up a “look-loop" where the macro continually scans 

your key presses, looking for one of the keys indicated in the 
IF. . .ELSE statements that follow. Specifically, the macro 
watches for: 


¢[Tab] 
[E7] 
¢{[Ctrl]-[Right] 
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o[Enter] 
o[Ctrl]-[Left] 


When you press one of these keys, the macro executes the instruc- 
tions following the appropriate (IF) statement. If none of these 
keys are pressed, it passes the key through to WordPerfect and 
repeats the loop. 


°Step 3 watches for the [Tab] key. When you press it, the macro 
inserts an [Indent] and repeats the loop. 


oStep 4 watches for the [F7] key. When you press it, the macro 
stops. 


°Step 5 watches for [Ctrl]-[Right]. When you press it, the macro 
adds 1 to variable 1 (this variable keeps track of the outline level), 
tabs to the next stop, and repeats the loop. 


o Step 6 watches for the [Enter] key. When you press it, the macro 
tabs over the specified number of stops as set by (VAR 1), then 
repeats the loop. 


oStep 7 watches for the [Ctrl}-[Left] key. When you press it, the 
macro subtracts 1 from variable 1, jumps over the paragraph num- 
bering code, erases the previous tab, then jumps back to the begin- 
ning of the line. It then repeats the loop. 


To use the macro, start it and type the entry for the first line of 
the outline. Press [Enter] to start each new line. When you want to 
step to the next outline level, press [Ctrl]-[Right]. When you press 
[Enter] again, the macro assumes you want to write another line at 
the same level. It automatically adds the correct number of tabs to 
return you to the same level you previously selected. You can go to 
the next level by pressing [Ctrl]-[Right] again, or you can go back 
to the previous level by pressing [Ctrl]-[Left]. When you are done 
with the outline, press [F7]. 


Enhanced Outline Macro 


OUTLINE1.WPM macro is almost the same as OUTLINE. WPM, but 
has a few added enhancements. 
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OUTLINELWPM (CHAP14 directory on Applications Disk) 
(DISPLAY OFF) 
{Date/Outline)62(Enter) 
4{Enter) 
(Indent) 
(DISPLAY ON} 
(ASSIGN})0~~ 
(ASSIGN) 1~0~ 
(LABEL) loop~ 
(LOOK) O~ 
(IF}"(VAR 0)"="(Tab)"- (Indent) (GO)loop~ 
(ELSE) 
(F)"(VAR 0)}"="{Exit}"~(Date/Outline)4(QUIT) 
(ELSE) 
(IF)"(VAR 0)"="(Word Right}"~ 
(ASSIGN) 1~(VAR 1)+1~ 
(Left) (Tab) (Indent) (Del) 
(GO)loop~ 
(ELSE) 
(IF)"(VAR 0)"="(Enter}"~ 
(Enter) 
(Esc) (VAR 1) (Tab) (Indent) 
{(GO)}loop~ 
(ELSE) 
(IF)"(VAR 0}"="(Word Left)"~ 
(ASSIGN) 1~(VAR 1)-1~ 
(Left) (Left) (Backspace) (Right) (Right) 
(GO)loop~ 
(ELSE) (VAR 0}(GO)loop~ 
(END IF)(END IF}J(END IFJ(END IF)(END IF) 


HOLLYWOOD-STYLE SCRIPT FORMATS 


Movie studios and producers expect scripts for television and movies 
to be in a specific format. Writing scripts on a word processor is ac- 
tually harder than writing them on a typewriter. If you are not care- 
ful, choosing the wrong formatting strategy with the word processor 
makes editing the script extremely difficult and time consuming. 
There are a number of stand-alone scriptwriting word processors 
on the market; WordPerfect is not one of them. It lacks the special 
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features most desired by studio and professional script typists, but 
WordPerfect is perfectly adept for use by writers, whose main con- 
cern 1s getting the action and dialog on paper and in the proper for- 
mat. Thanks to WordPerfect styles and macros, writing and editing 
scripts is made much simpler than it used to be. 


Script Formats 


At their basic level, scripts can be divided into two discrete formats: 
action and dialog. Action and dialog sections of a typical script are 
shown in Figure 14—6. The action format places the text between two 
wide margins on either side of the page. You can actually use 
WordPerfect’s default format settings for the action sections of your 
script. That leaves setting up special margins and tab settings just 
for the dialog sections 

Dialog sections contain the name of the character, an optional 
description of the delivery of the line (often an adverb), and the 
dialog text. The character name can be indented a certain number 
of spaces from the left margin, or centered between the margins. 


Setting Script Formats Using Styles 


We’ll assume that the WordPerfect default format meets your 
criteria for the action sections of your script, and that all you need 
to do is define the format for the dialog sections. First, create a style, 
name it DIALOG, and set its type to Open. As shown in Figure 14- 
7, define the style as follows 


e Left margin 2.5". 
e Right margin 2.5". 
eTab Set 0", 3.3", 4.3". 


To use the style, select it and turn it on. Press the [Tab] key twice 
to express to the center of the page to enter the name of the charac- 
ter; press the [Tab] key once to enter the character’s dialog. Keep 
the style on until you are ready to write an action section. To revert 
to normal formatting for the action sections, select the DIALOG style 
and turn it off. 
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EXT. OCEAN -- LIFEBOAT -- DAY 


Everyone is quite. the water is calm and the fog still hangs in the 
air. The crew -- what remains of it -- rest in the small lifeboat 
as 4t gently drifts in the water. 


DISSOLVE TO: 
LATER 


They all asleep. The fog, thicker now, curls around the boat 

and blocks the view of the water below. Suddenly, we HEAR the sound 
of the bottom of the boat scraping against rock. Dan bolts upright, 
his muscles tight. He looses his balances and trips over the 
transom, ungracefully falling out of the boat. 


DAN -- GROUND 


His head plops onto beach sand. Slowly, the revelation become clear 
and a smile forms on his face. 


BYRON 
Hey everyone! Look! 


As the fog begins to lift, we recognize the area as a small island. 
The crew jumps out, and most falter to the ground. 


DAN 
I can’t believe it. It’s like -- 
it’s like a miracle. Nothing less. 


KEITH 
This is perfect. 


BYRON 
(Still ecstatic) 
I know! Someone will rescue us for 
sure now. 


KEITH 
Yes, but don’t you see. This is a 
perfect change. This is something 
I’ve waited for for years. 


BYRON 
I don’t follow. 
KEITH 
Idiot! People have already died, 


right? 


FIGURE14-6 SAMPLE PAGE OF SCRIPT 
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FIGURE 14-7 DIALOG SCRIPT DEFINITION STYLE 


Note that WordPerfect normally stores styles with the document, 
so if you want to share the DIALOG style with other documents, the 
easiest method is to save it in a separate style file (press option 6 in 
the Styles menu) for later retrieval. A good name is DIALOG.STY. 
If you have created several styles in the document, you'll save them 
all in the DIALOG.STY file. 


Setting Script Formats Using Macros 


Macros can also be used to set formats for writing scripts, Actually, 
you can use macros in two ways: 


eTo turn the script style on and off; helpful to reduce the number 
of keystrokes needed to apply styles. 


eTo set all of the desired formats by duplicating the appropriate 
keyboard commands. 
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You can also use macros to prevent the dialog text from becoming 
separated from the character name at a page break. This minimizes 
the time you must spend reviewing the manuscript prior to printing. 

(Mark Text}3 

Basic Dialog Macro—The dialog macro uses standard formatting, 
applicable to both action and dialog sections: 


e Left margin 1". 
Right margin 1". 
eTab Set 0", 2.5", 3.3", 4.3", 6.0", 6.5". 


You can set the format as a style and apply it at the beginning of 
the script, or you can embed the codes in a script template document. 
Retrieve the template document to start each new script, then save 
it under a different name. 

To write an action section, just type as usual. Instructions such as 
DISSOLVE TO and FADE OUT can be placed at the 4.3" tab stop. 
Prepare the following macro to write the dialog sections. 


CHAR.WPM 
1. (Center) 
2. {ASSIGN} 1~~ 
(LABEL)loop~ 
(VAR 1) 
{(LOOK)}1~ 
(IF})"(VAR 1)"="(Enter)"~ (Enter) (GO)indent~ 
(ELSE) (GO)loop~ 
(END IF} 
3. (LABEL)indent~ 
(L/R Indent) 
4, (ASSIGN) 2~~ 
(LABEL)loop1~ 
{LOOK}2~ 
IF)" (VAR 2}"="(HPg}"~ 
(Enter}@ 
(Search Left) {Center} (Search) 
(Block) (Down) (Down) (End) (Format)y 
{ELSE} 
(IF) "(VAR 2}"={Enter}~ 
(Enter) (L/R Indent) (GO}loop1~ 
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(ELSE) (VAR 2)(GO)loop1~ 
{END IF)(END IF) 
5. (Search) @{Search) (Backspace) 


°Step 1 centers the character name between the margins. 


°Step 2 sets up a loop and waits for you to press the [Enter] key. 
When you do, the macro jumps to the "indent" routine. 


°Step 3 is the “indent” routine which indents the dialog text both 
left and right to the next tab stops. 


°Step 4 sets up a loop and waits for you to press either the [Enter] 
key or [Ctrl]-[Enter]. Pressing [Enter] adds a new line and rein- 
dents the dialog text. Pressing [Ctrl]- [Enter] (normally a hard 
page) protects the first three lines of the character dialog section, 
as depicted in Figure 14—8. The macro adds a temporary "@" 
character, used in step 5. As long as you don’t press either [Enter] 
or [Ctrl]-[Enter], the macro jumps back to the “loop1" label. 


°Step 5 searches for the "@" character (denoting the end of the 
dialog text for the character) and deletes it. 


FIGURE14-8 PROTECTING FIRST THREE LINES WITH BLOCK 


since we got on this island? 


MIKE 
Uhat isn’t strange about it? 


SHIRLEY 
Cueakly) 
I mean the water. It’s like no 
other water I’ve ever seen. It 
just floats along. And the fog. 
It’s everywhere, yet it doesn’t 
Doc 1 Pg 1 Ln 15 Pos 18 


C>#Indent*+JWUhat CUNDJisn’tlCund] strange about it7CHRtI 

CHREJ 

EY ICBlock Pro: OnJSHIRLEY(C/’A/FIrtICHRt] 
C~Indent¢]CTabi¢ueakly)CHRtI 

C~Indent¢l]I mean the water. It’s like nolBlock Pro! OfFfICSRt) 
other water I’ve ever seen. Itl€SRtI 

just floats along. And the fog. CSRtI 

It’s everyuhere, yet it doesn’ t{SRt] 

move. [HRE] 


Press Reveal Codes to restore screen 
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Chained Dialog Macro—You can reduce extra keystrokes by creat- 
ing individual character macros and chaining these to a modified 
version of the "working end" of CHAR.WPM, detailed above. Here's 
an example of a character macro: 


(Center) 
CHARACTER NAME 
(Enter) 

(L/R Indent} 
(CHAIN)talk~ 


This macro centers CHARACTER NAME between the margins, 
starts a new line, and indents it. It then chains to the TALK.WPM 
macro, shown below. After the initial indent, you can start typing or 
press the [Tab] key to place a description of character dialog 
delivery. 


The TALK.WPM macro comprises steps 4 and 5 of CHAR.WPM. 


TALK.WPM (CHAP14 directory on Applications Disk) 
(ASSIGN}2~~ 
{LABEL)loop1~ 
(LOOK)2~ 
(IF)"(VAR 2)"="(HPg)}"~ 
(Enter)@ 
(Search Left) (Center) (Search) 


(Block) (Down) (Down) (End) (Format)y 
(ELSE) 


(IF)"(VAR 2}"=(Enter)~ 
(Enter) {L/R Indent}(GO)loop1~ 
(ELSE)(VAR 2)(GO)loop1~ 
(END IF)(END IF) {Search}@(Search) (Backspace) 


MACROS FOR BUILDING A TABLE OF 
CONTENTS AND INDEX 


The biggest job in building a table of contents or index in Word- 
Perfect is marking the text you want included in the list. As you 
might have guessed, macros make the process a lot easier. 
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Marking for a Table of Contents 


Text for a table of contents is usually composed of the headings and 
subheadings in your document. WordPerfect lets you assign dif- 
ferent levels to table of contents entries. This macro allows you to 
assign the level you want. If you plan on setting all entries at the 
same level, you can incorporate the appropriate keystrokes in the 
macro. 


MARKTOC.WPM (CHAP14 directory on Applications Disk) 


Key Sequence What it Does 
1. (Ctrl]-[F10] Starts macro definition. 
2. marktoc Names macro. 
[Enter] 
3. Mark table of Describes macro. 
contents [Enter] 
4. (Alt]-[F4] Starts block. 
5. [End] Moves cursor to the end of the line. 
6. [Alt]-[F5] Chooses Mark Text menu. 
7.1 Selects Mark ToC option. 
8. [Ctrl]-[F10] Ends macro definition. 


To use the macro, first position the cursor in front of the heading 
you want to mark. Start the macro, then enter the desired table of 
contents level number (press numbers 1 to 5). After pressing a num- 
ber, WordPerfect returns to the main document, where you can mark 
another entry for the table of contents or generate the table. Word- 
Perfect adds the proper table of contents mark code, as shown in 
Figure 14-9, to the document. 

Remember that you can’t actually generate the table of contents 
without first defining it. Refer to the WordPerfect manual on how to 
define the table of contents. If you create lots of documents each with 
a table of contents, you may wish to automate this process by using 
a macro which actually generates the table of contents (after it has 
been defined and all the entries marked). This macro can also be 
used to generate an index, list, and table of authorities after these 
have been defined and marked. 
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your Videos, You’ll learn about getting the best sound from your 


camcorder, as uell as all about using supplementary microphones, 
You’1l also discover some ways to expertly re-record the 


soundtrack of your home tapes. 


OF CAMCORDERS AND MICROPHONES _ 
Dt \UPSB\CAMSOUND 


Doc 1 Pg Z Ln Z9 Pos 46 


soundtrack of your home tapes. CHRt] 
CHRtI 
CHark: ToC,1JOF CAMCORDERS AND MICROPHONES CEnd Mark: ToC, 1I[Uahin®) 
Camcorders come with their own build-in microphone. The CSRt] 
microphone (or "nic’’) is typically omni-directional: that is, it CSRt] 
picks up sounds equally well in most all directions. While this CSRt] 
ensures you of recording all the voices at your kid’s birthday CSRt] 
party, the lack of sonic discrimination also means your CSRt1 
soundtrack is filled uith extraneous noises. Depending on where CSRt] 
the microphone is mounted on the camcorder, you may hear: CHRE] 


Press Reveal Codes to restore screen 


FIGURE14-9 REVEAL CODES SCREEN WITH TOC CODE 


GENERATE.WPM (CHAP14 directory on Applications Disk) 


Key Sequence What it Does 
1. (CtrljJ-[F10] Starts macro definition. 
2. generate Names macro. 
[Enter] 
3. Generate list, etc. Describes macro. 
[Enter] 
4, [Alt]-[F5] Chooses Mark Text menu. 
5.65y Selects Generate option; answers Yes to prompt 
6. (Ctrl]-[F10] Ends macro definition. 
Marking an Index 


The process of marking text for an index is similar to that of mark- 
ing text for a table of contents. The biggest difference is that you 
mark only single words or phrases for an index, not the entire line. 
The macro that follows marks the word closest to the cursor 
automatically. It uses WordPerfect’s default suggestions for index 
headings and subheadings. While this macro may not always mark 
the words the way you want for the index, it will work in your favor 
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over 80 percent of the time. You can always go back and remark a 
word or a phrase manually if the index entry doesn’t suit you. 


MARKIND.WPM (CHAP14 directory on Applications Disk) 


Key Sequence What it Does 
1. [Ctrl]-[F10] Starts macro definition. 
2. markind Names macro. 
[Enter] 
3. Mark index Describes macro. 
[Enter] 
4. [Alt]-[F5] Chooses Mark Text menu. 
5.3 Selects Mark Index option. 


6. [Enter] [Enter] Accepts suggestions for index heading 
and subheading. 
7. (Ctrl]-[F10] Ends macro definition. 


Be sure to define the index at the end of the document before at- 
tempting to generate it. 


Enhanced Index Marking Macros 


Suppose you already know what word you want to include in the 
index but don’t want to search through the entire document, word 
by word, to find all its occurrences. While you could generate a con- 
cordance for such a job, the concordance only lists the occurrence of 
each word, and not how the word was used in the text. 

Here’s an example: Using a concordance file to indicate all the oc- 
currences of the word "clone" in a document or book only lists those 
pages that contain "clone." If you desire an effective index, you'll 
need to describe how "clone" is used. On one page, the word may refer 
to IBM PC compatibility on a hardware level, and on another page 
it may refer to compatibility on a software level. 

The macro presented here prompts you to enter the word or phrase 
you want to look for, then automatically marks it for indexing. This 
macro lets you enter another word or phrase for both the index head- 
ing and subheading. 


INDEXWRD.WPM (CHAP14 directory on Applications Disk) 
1. (TEXT)0~Enter the word or text you want to index. ~ 
2. (LABEL) start~ 
{Search} (VAR 0} (Search} 
(Mark Text)3 
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3. (ASSIGN) 2~0- 
(ASSIGN} 1~~ 
(LABEL) loop~ 
(VAR 1) 
(LOOK) 1~ 
(IF)" (VAR 1)"="({Enter)"~{GO}count~ 
{ELSE) (GO) loop~ 
(END IF) 
4, (LABEL) count~ 
(ASSIGN)2~(VAR 2}+1~ 
(IF)"(VAR 2)=2~{GO}doanother~ 
(ELSE) {GO}loop~ 
(END IF} 
5. (LABEL)doanother~ (CHAR)3~Do another of same word? 1 Yes; 
No. -~ 
(IF) (VAR 3}=1~{Search) (GO)start~ 
(ELSE) 
(IF] (VAR 3}=2~{Enter) (QUIT) 
{END IF) (END IF) 
(GO) doanother~ 


Step 1 asks you to enter the word or phrase you want to index. 
Your answer is stored ìn variable 1. 


¢Step 2 searches for the next occurrence of your entry. When found, 
the macro chooses the Mark Text menu and selects the Mark 
Index option. 


‘Step 3 waits for you to press the [Enter] key. When you do, the 
macro jumps to a routine called "count." 


Step 4is the "count" routine. After pressing the [Enter] key twice 
(denoting that you have entered the heading and subheading for 
the index entry), the macro jumps to the "doanother" routine. At 
that time, WordPerfect marks the current selection for the index. 


Step 5 is the "doanother” routine. It asks if you want to look for 
another occurrence of the same word or phrase you originally 
entered. Answering yes (press 1) brings you back to the ‘start’ 
routine; answering no (press 2) quits the macro. The extra 
(Search) instruction after {IF){VAR 3)=1~ prevents the macro 
from searching for the [Index] code on the next round. 
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Use the following macro if you suspect that the word or phrase 
ours many times throughout a document, and you don’t need to in- 
dicate a different heading or subheading for each instance. This 
macro is easier to use than a concordance file. 


INDEX1.WPM (CHAP14 directory on Applications Disk) 
1. (TEXT)0~Enter the text you want to index. - -~ 
2. (Search) (VAR 0) (Search) 

(Mark Text)3 

3. (ASSIGN})2~0~ 
(ASSIGN) 1~~ 
(LABEL)loop~ 
(VAR 1) 

(LOOK) 1~ 

(IF)"(VAR 1)"="({Enter)"~(GO)count~ 
(ELSE} (GO) loop~ 

(END IF) 

4. (LABEL)count~ 
(ASSIGN)2~(VAR 2)+1~ 
(IF)"(VAR 2)=2~{(GO)nextround~ 
(ELSE) (GO)loop~ 
(END IF} 

5. (LABEL)nextround~ 
(Enter) 

(DISPLAY OFF} 
(Search) (VAR 0) (Search} 
(Mark Text)3 

{Enter} (GO)nextround~ 


Step 1 asks you to enter the word or phrase you want to index. 
Your answer is stored in variable 1. 


¢Step 2 searches for the next occurrence of your entry. When found, 
the macro chooses the Mark Text menu and selects the Mark 
Index option. 


«Step 3 waits for you to press the [Enter] key. When you do, the 
macro jumps to a routine called "count." 


Step 4 is the "count" routine. After pressing the [Enter] key twice 
(denoting that you have entered the heading and subheading for 
the index entry), the macro jumps to the "nextround" routine. At 
that time, WordPerfect marks the current selection for the index. 
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¢Step 5 is the "nextround" routine. It repeats the search and marks 
text process repeatedly throughout the entire document. 


MACROS FOR WRITING AND EDITING 


Macros can be used for just about any text writing and editing task. 
The type of manuscripts you create, and your work habits, will lar- 
gely dictate the kinds of macros that will be of most use for you. 
The following is a collection of short macros you can create to help 
your writing and editing go faster.Note that changes to fonts and 
styles (using SIZE.WPM and STYLE.WPM for example) cannot be 
done unless you are using and Enhance Graphics Display, Video 
Graphics Array card. When using a Hercules-graphics adapter or a 
color graphics adapter, you can view font and style changes using 
the Print View feature (press [Shift]-[F7], then press 6).All the fol- 


lowing macros are located in the CHAP14 directory on the Applica- 
tions Disk. K 


DELPAR.WPM—To Delete a Paragraph 
(DISPLAY OFF) 
{Move}23 
(DISPLAY ON} 


Position the cursor at the beginning of the paragraph and start 
the macro. 


DELSENT.WPM {DISPLAY OFF)—To Delete a Sentence 
(DISPLAY OFF} 
{Move)12 
(DISPLAY ON} 


Position the cursor at the beginning of the sentence and start the 
macro. 


COPY.WPM—To Copy a Block of Text to the Buffer 
{Block} 
(CHAR)1~Move the cursor to the end of the block; press Enter 
when finished. - -~ 
(ASSIGN) 1~~ 
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(LABEL) loop~ 

(VAR 1) 

(LOOK) 1~ 

(IF)"(VAR 1)"="(Enter)"~(GO)finish~ 
{ELSE)(GO)loop~ 

(END IF) 

(LABEL) finish~ 

(DISPLAY OFF) 

(Move) 12(Cancel} 

(DISPLAY ON) 


Move the cursor to the beginning of the block of text you want to 
copy. Start the macro, then position the cursor at the end of the 
block. Press [Enter] to copy the block to the buffer. 


CUT.WPM—To Cut a Block of Text and Place It In the Buffer 
{Block} 
{CHAR)1~Move the cursor to the end of the block; press Enter 
when finished. -=~ 
(ASSIGN) 1~~ 
(LABEL) loop~ 
(VAR 1) 
(LOOK) 1i~ 
(IF)"(VAR 1)"="(Enter)"~(GO)finish~ 
(ELSE) (GO)loop~ 
{END IF) 
(LABEL)finish~ 
(DISPLAY OFF) 
{Move} 11({Cancel) 
(DISPLAY ON) 


Move the cursor to the beginning of the block of text you want to 
cut. Start the macro, then position the cursor at the end of the block. 
Press [Enter] to cut the block and place it in the buffer. 


PASTE.WPM—To Paste Previously Cut or Copied Text 
{Move)41 


Move the cursor to the spot you want the previously cut or copied 
text to go. Start the macro. 
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BOLD.WPM—To Bold-Face Already Written Text 
{Block} 
(CHAR) 1~Move the cursor to the end of the block; press Enter 
when finished. - -~ 
(ASSIGN) 1~~ 
(LABEL)loop~ 
(VAR 1) 
(LOOK) 1~ 
(IF}"(VAR 1)"="(Enter)"~(GO)finish~ 
{(ELSE}(GO)loop~ 
(END IF) 
(LABEL}finish~ 
(DISPLAY OFF) 
(Bold) 
(DISPLAY ON) 


Move the cursor to the beginning of the text you want to make 
bold. Start the macro, then position the cursor at the end of the block. 
Press [Enter] when done. 


UNDERLN.WPM—To Underline Already Written Text 
(Block) 


(CHAR}1~Move the cursor to the end of the block; press Enter 
when finished. - -~ 

(ASSIGN) 1~~ 

(LABEL)loop~ 

(VAR 1) 

(LOOK) 1~ 

(IF)"(VAR 1)"="(Enter)"~(GO)finish~ 

(ELSE) (GO)loop~ 

(END IF) 

(LABEL)finish~ 

(DISPLAY OFF) 

(Underline) 

(DISPLAY ON) 


Move the cursor to the beginning of the text you want to under- 


line. Start the macro, then position the cursor at the end of the block. 
Press [Enter] when done. 
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FONTSIZE.WPM—To Change the Font Size of Already Writ- 
ten Text 

(Block) 

(CHAR) 1~Move the cursor to the end of the block; press Enter 

when finished. - -~ 

(ASSIGN) 1~~ 

(LABEL}loop~ 

{VAR 1) 

(LOOK) 1~ 

(IF)"(VAR 1}"="(Enter)"~(GO)finish~ 

{(ELSE)(GO}loop~ 

(END IF} 

(LABEL)finish~ 

(Font) 1 


Move the cursor to the beginning of the text you want to change. 
Start the macro, then position the cursor at the end of the block. 
Press [Enter] when done. Choose a size from the menu that appears. 


FONTSTYL.WPM—To Change the Font Style of Already Writ- 
ten Text 

(Block) 

(CHAR) 1~Move the cursor to the end of the block; press Enter 

when finished. - -~ 

(ASSIGN) 1~~ 

(LABEL) loop~ 

(VAR 1} 

(LOOK) 1~ 

(IF}"(VAR 1)"="(Enter}"~(GO)finish~ 

(ELSE){GO)loop~ 

{END IF) 

{LABEL})finish~ 

{Font}2 


Move the cursor to the beginning of the text you want to change. 
Start the macro, then position the cursor at the end of the block. 
Press [Enter] when done. Choose a size from the menu that appears. 
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SIZE.WPM—To Change the Font Size Before Writing 

(PROMPT) (Up)Choose a size and start writing; press Right Arrow 
when done.~ 

{Font}1 

(ASSIGN) 1~~ 

(LABEL) loop~ 

(LOOK) 1~ 

(IF EXISTS)1~(VARD(PROMPT)(UP){DEL to 
EOL)~(PROMPT)(DEL to EOL)~ 

(ELSE) (GO)loop~ 

(END IF) 


Start the macro and select a size. To turn the size off, press the 
[Right] key (this skips the cursor over the font size off code). 


STYLE.WPM—To Change the Font Style Before Writing 

(PROMPT) (Up)Choose a style and start writing; press Right 
Arrow when done.~ 

(Font)2 

(ASSIGN) 1~~ 

(LABEL) loop~ 

{LOOK)1~ 

(IF EXISTS)1~{(VARI) (PROMPT)(UP){(DEL to EOL)~ 
(PROMPT)(DEL to EOL)~ 
(ELSE) (GO)}loop~ 

(END IF) 


Start the macro and select a style. To turn the style off, press the 
[Right] key (this skips the cursor over the font style off code). 


CENTER.WPM—To Center Already Written Text 
(Block) 
(CHAR) 1~Move the cursor to the end of the block; press Enter 
when finished. - -~ 
(ASSIGN) 1~~ 
(LABEL) loop~ 
(VAR 1) 
(LOOK) 1~ 
(IF)" (VAR 1}"="{Enter)"~{GO)finish~ 
(ELSE)(GOJloop- 
(END IF) 
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{LABEL)finish~ 
(Centerjy 


Move the cursor to the beginning of the block you want to center, 
then start the macro. Position the cursor at the end of the block and 
press [Enter]. Note that centering a block of text ends each line with 
a hard return. | 


CENTERST.WPM—To Center A Line of Previously Written 
Text 

(when the cursor is at the start of the line) 

{DISPLAY OFF} 

{Block) 

{End} 

{Center}y 


Use the macro after typing a line (the cursor is at the beginning 
of the line). 


FIGURE 14-10 EFFECT OF HANGING INDENT 


HANGING INDENT 


Microphones capture sound within a specified pattern, The tuo 
most common patterns for consumer microphones are omni and 
cardiod. The omni (for omni-directional) microphone picks 
up sound equally in all directions. The cardiod microphone 
limits its sensitivity immediately behind the microphone, 
which cuts background noise and reduces feedback. For most 
camcorder shooting, you’ll probably want a cardiod mic, 


NESTED INDENT 


. A special, highly directional microphone is the ‘shotgun 
mic,“ so-called because it looks like the barrel of a 
shotgun. Shotgun mics pick up sound directly in front, 
rejecting those that occur at the sidos and from behind. 
The rejection of sound works on the principle of 
cancellation of audio waves, so the barrel of the shotgun 
mic is riddled with tiny holes. Shotgun mics are vory 
susceptible to effects of uind, particularly through the 
barrel holes, so it’s vitally important that you use a 
wind-sock on the entire length of the microphone. 


D: \UPSB\CAMSOUND Doc 1 Pg 4 Ln 4Z Pos 66 
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CENTERED.WPM—To Center A Line of Previously Written 
Text 

(when cursor is at the end of the line) 

(DISPLAY OFF} 

(Block} 

{Home} (Left) 

{Center)y 


Use the macro after typing a line (the cursor is at the end of the 
line) but before pressing [Enter). 


HANGIND.WPM—To Create a Hanging Paragraph Indent 
(Indent) 
{Left Mar Rel) 
(Screen)0 


Use the macro before or after writing text. The (Left Mar Rel) code 
is created by pressing [Shift]-[Tab]. The (Screen)0O instruction 
rewrites the screen so that the text appears properly in the display. 
The effect of the hanging indent macro is displayed in Figure 14- 
10.rEVERSE THE (Indent) and {Left Mar Rel) codes to create a 
nested indent. 


CENTAB.WPM—To Center a Line of Text Starting At a Tab 
Stop 

(Center) (Enter) 

(Backspace) 


Position the cursor at the tab stop where you want the text 
centered from. Invoke the macro, then write the text. 


SUPER.WPM—To Set the Following Text as Superscript 
(DISPLAY OFF) 
{Font}11 
(DISPLAY ON} 


Start the macro before writing the text. To turn the style off, press 
the [Right] key. 


SUB.WPM—To Set the Following Text as Subscript 
(DISPLAY OFF} 
(Font) 12 
(DISPLAY ON) 
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Start the macro before writing the text. To turn the style off, press 
the [Right] key. 


MACROS FOR DOCUMENT CONVERSION 


If you have ever imported text from another IBM PC, or program, 
you know that the process isn’t 100 percent foolproof. Even with 
WordPerfect’s CONVERT program, a number of files are imported 
with odd characters or hard returns within paragraphs where there 
should be soft returns. A set of macros can greatly ease the trouble 
importing text to WordPerfect. By the same token, you can easily 
develop macros for preparing files for exporting from WordPerfect. 

One of the most common problems with imported text is that they 
oftenlack soft carriage returns within the paragraphs. If you want 
to edit the text in WordPerfect, you’ll need to convert the hard car- 
riage returns in the paragraph so that WordPerfect will be able to 
word-wrap at the end of each line. Of course, you need to keep the 
hard return that marks the end of the paragraph. 

WordPerfect has an option in the Text In/Out menu where you can 
choose to import an ASCII (or DOS) text file and convert line 
feed/carriage return characters to WordPerfect soft returns. The fea- 
ture doesn’t work with many imported files so you usually need to 
change the return characters manually. 

The exact way you do it will depend on the format of the text as 
well as the the original word processor that created it. I’ve developed 
several systems for converting ASCII documents that I capture 
through a modem and telecommunications program. Both do most 
of the work for me, although I still need to go through the document 
and make minor corrections here and there. 


Revealing Hard Carriage Returns 


You can always see the [HRt] code in a document by choosing Reveal 
Codes, but your view of the document is cut in half. An easier way 
to view hard returns is to change the paragraph mark character. 
Normally, the paragraph character is not visible, but you can turn 
it into any other character from within the Setup menu. 
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SPOMINI Remarks 
Introduction to the session. T 
Welcoma.7 
11. Last minute updates. T 
Introduction to panel members. 7 
A. L. Bean.T 
ii. U. Markhan.T 
11i. B. Travist 
fy. 0. R. Lud 
Efforts of Business Development 
a. Film industry. 
b. Record industry. T 
c. Publishing industry.7 
i. Booksi 
C1) TradeT 
(2) PaperbackT 
(3) Taechnicalt 
Magazines 
(1) General circulation 
(Z) Subscriptiont 
Ca) Paidd 
(b) Controlled auditT 
11i. Greeting cards 
DI: \UPSONMISCNOUTLINE Doc 1 Pg 1 Ln 1 Pos 10 


FIGURE 14-11 SCREEN WITH PARAGRAPH MARKS 


Key Sequence What it Does 

1, [Shift]-[F1] Selects Setup menu. 

2.36 Chooses Display and Paragraph 
Character options. 

3. [Ctrl]-2 4,5 Enters { character using 


compose key (you can select any other 
character from WordPerfect’s character 
sets as long as your computer will 
display it). 

4. [Enter] [Enter] Exits Setup menu. 


Now the document is filled with paragraph symbols, as shown in 
Figure 14-11. Converting the document, either manually or with the 
aid of macros, is not much easier. You can revert to regular (in- 
visible) hard returns, or repeat the process by pressing [Enter] as 
the paragraph symbol. You may wish to encode the turn-on and turn- 
off paragraph symbols as macros. They have already been written 
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a Most computer programs share a common trait: they 
are T 

designed to help you work better, faster, and moro 
efficiently. T 

By using the right software, your work takes on a 
more T 

polished, professional look. The end rasult, ina 
round—about TT 

way, is a rewarding reflection on you. But one type 
of T 

computer softuare is specifically designed to 
promote, improve, 7 
and onrich you directly. For the lack of a bottor 
name, call it 7 

“helpuare’ — softuare that helps you loose uelght, 
urite a 7 

better resume, score higher on the SATs, cook bettar 
meals, T 

{mprove your love life, move you up the career 
ladder, and 7 

more. WT 
WT 


Though examples of helpware have been around for a 
long time 7 
D:\wpS@\TEXT. DOC Doc 1 Pg 1 Ln 1 Pos 10 


FIGURE 14-12 IMPORTED STANDARD MANUSCRIPT 


for you and included on the Applications Disk as PARSYMB.WPM 
(turn on J symbol) and PARNORM.WPM (turn off symbol). 


Converting Standard Manuscript Documents 


While there really isn’t any such thing as a “standard manuscript," 
the term is used here to more easily describe the common double- 
space manuscript format used in term papers, magazine articles, 
novels, etc. The first line of each paragraph is typically indented five 
to 10 characters from the left margin. Such a standard manuscript, 
written on one word processor and retrieved by WordPerfect in 
ASCII format, is shown in Figure 14- 12 (paragraph symbols are 
shown on screen). What an ugly mess! 

But by analyzing the basic format of the manuscript, it’s possible 
to arrive at a means of easily removing the extra hard carriage 
returns. To convert the document, you want to accomplish these two 
goals: 
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¢Turn the empty spaces in the first line of each paragraph to Word- 
Perfect [Tab] codes. 


¢Remove the extra hard returns in the middle of the paragraphs, 
but keep the hard return at the end of each paragraph. 


You can’t remove all the hard returns in a document or you lose 
the paragraph divisions. Luckily, the manuscript format provides 
some help. The start of each new paragraph begins with empty 
spaces, which represent a tab. You can use the tab as a means to 
identify paragraphs. Once the paragraphs are identified, the extra 
returns can be removed. 

Two macros are required for converting standard manuscript 
ASCII documents: a space-to-tab converter and a hard return 
remover. 


SPTOTAB.WPM—Space-to-Tab Converter Macro (CHAPI4 
directory on Applications Disk) 

(Search) 

(Replace}n-:--- {Search} 

(Tab) (Search] 


This macro searches for five spaces, then replaces them with a 
[Tab]. If the indention in your manuscripts is more or less than five 
spaces, modify the macro accordingly. 


RMHRT.WPM—Hard Return Remover Macro (CHAP14 direc- 
tory on Applications Disk) 

(Search) (Tab} (Search) 

(Block) 

(Search) (Tab} (Search) 

(Left) (Left} (Left) 

(Replace}n(Enter} (Search) (Search) 

(Macro)RMHRT {Enter} 


This macro searches for [Tab] codes, then turns block on to select 
the text to change. The three {Left} instructions back up the cursor 
so that the last hard return in the paragraph isn’t removed. You may 
need to add or remove (Left) instructions to suit the needs of your 
converted manuscripts. The macro repeats itself when it reaches the 
end. Note that the macro may be caught in an endless loop if there 
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are two or more [Tab] codes adjacent to one another. If this is the 
case in your document, skip over the codes or temporarily remove 
them. 


Block Removal of Hard Carriage Returns 


Another approach to converting standard documents is provided 
in the next macro. Here, you manually select the entire paragraph 
except for the last hard carriage return. WordPerfect changes the 
hard returns to soft returns, but only within the blocked area. 


TOSOFT1.WPM (Block) (CHAP14 directory on Applications 
Disk) 

[BLOCK] 

(CHAR) 1~Move the cursor to the end of the block; press Enter 

when finished. - -~ 

{ASSIGN) 1~~ 

(LABEL) loop~ 

(VAR 1) 

(LOOK) 1~ 

(IF)"(VAR 1)"="(Enter)"~(GO)finish~ 

(ELSE) (GO)loop~ 

{END IÐ) 

(LABEL) finish~ 

(Replace}n({Enter) {Search} (Search) 


Alternative Hard Carriage Return Remover 


Some documents may have extra spaces before the hard carriage 
returns. These should be removed before converting the hard returns 
to soft returns. Here is a suitable macro for this purpose: 


TOSOFT2.WPM (CHAP14 directory on Applications Disk) 
& & 
{Block} 
(CHAR) 1~Move the cursor to the end of the block; press Enter 
when finished. - -~ 
(ASSIGN) 1~~ 
(LABEL) loop~ 
(VAR 1} 
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(LOOK) 1~ 

(IF)"(VAR 1}"="{Enter)"~{GO)finish~ 

(ELSE) (GO)loop~ 

{END IF) 

(LABEL) finish~ 

(Replace)n- (Enter) (Search} (Enter) (Search) 
(Search Left) (Enter) (Search) (End) (Left} 

(Block} (Search Left) &&(Search) 
(Replace}n(Enter) (Search) {Del to EOL) (Search) 
(Search Left}&&(Search) Backspace) (Backspace) 


This macro is the same as the previous one except that it first 
removes one extra space before each hard return and replaces it just 
with a hard return. The macro then searches backwards to find the 
"&&" characters originally left to mark the beginning of the block. 
The paragraph is reselected and the macro now replaces all the hard 
returns with nothing (the (Del to EOL} instructions assures that the 
Replace With: string is empty). Finally, the macro backs up once 
more and deletes the "&&" marker characters. 


Converting Secondary Merge Files to Regular 
Documents 


A secondary merge file contains “Rs to designate the end of each 
field and “Es to designate the end of each record. Many IBM PC 


FIGURE 14-18 FIELDS AND RECORDS 


Fields 


Records 
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programs, particularly electronic spreadsheet applications such as 
Lotus 1-2-3 and Microsoft Excel, generally expect field/record infor- 
mation to be in column/line organization. As depicted in Figure 14— 
13, each line denotes a record and each column, delimited by a 
comma or tab, denotes a field. 

Although the CONVERT program included with WordPerfect per- 
mits you to export secondary merge files to comma- and tab- 
delimited ASCII files, you may wish to have more control over the 
conversion process. You can readily change WordPerfect secondary 
merge files with a macro. STRIP1.WPM converts secondary files to 
column/line format, ready for exporting to a program like 1-2-3 or 
Excel. 

This macro assumes that each record is separated by a “E merge 
character and a hard return, and that each field is separated by a 
AR merge character and hard return. Commas are uSed to separate 
the fields within each record. 


STRIP1.WPM (CHAP14 directory on Applications Disk) 
(DISPLAY OFF} 
(ON NOT FOUND)}(GO)}stripr~~ 
(Home) {Home}{Up) 


FIGURE 14-14 BEFORE CONVERSION 


Penny Points to Paradise*R 
Tony Young~R 

1951°R 

T? minutes*R 

b/u*R 

Great Britian*R 

Harry Secombe*R 

Paddy O’Neil*R 


Down Among the Z Men*R 
Mcclean Rogers~R 
195Z^R 

71 minutes*R 

b/u*R 

Great Britian*R 


The Goons^R 
“R 


^E 


Orders Are Ordaers^R 

David Paltenghi*R 

1954^R 

T8 minutes*R 

D: \upPS8NMISCNSELLERS Doc Z Pg 1 Ln 1 Pos 18 
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Penny Points to Paradise Tony Young 1951 7? minutes 
Great Britian Harry Secombe Paddy 0O’Neil 


Down Among the Z Men Mcclean Rogers 1952 
Great Britian The Goons 


Orders Are Orders David Paltenghi 1954 
Great Britian Brian Reece Margot Grahame 


John and Julie Uilliam Fairchild 1955 82 minutes 
Great Britian Colin Gibson Leslie Dudley ^E 
aio oe a 


wenny Points to ParadiseCTabJ]Tony Young(Tab)1951[. Tab 177 Eee eet Tabb ul TADJIDSA 
t) 


Great Britian(TablHarry Secombe({Tab]Paddy 0’ Neil€TabjJ*ECHPg) 


Down Among the Z Men(Tab]Mcclean Rogers({TablJ19S2{€Tabj71 minutesl€Tablb/wlTabIJCDSR 
tJ 


Great Britian(CTab]The Goons[TabJCTabJ)*ECHPg] 
Orders Are Orders(Tab]David PaltenghiCTabl]1954(Tabj78 minutesl Tablib/ul TabICDSRt] 


Great Britian€Tab]Brian Reacel[Tabl]Margot GrahamelTab)*ECHPg] 
John and JulieCTabJUilliam Fairchild£€Tab119SSCTabIJBZ minutes([TabJcolor[TabI£DSRt 


Press Reveal Codes to restore screen 


FIGURE 14-15 AFTER CONVERSION 


(Replace}n(4E} (Enter) 
{Search} (Enter) (Search) 
{(LABEL)stripr~ 

{Home} (Home) (Up) 
(Replace}n(“R) (Enter) 
(Search) ,(Search) 
(DISPLAY ON} 


Some programs require tab delimited files (although most accept 
both comma- and-tab delimited files). If so, change the comma in the 
final Replace With: string (second-to-last instruction in the macro) 
to a (Tab). The tab-delimited macro is included on the Applications 
Disk under the name STRIP2.WPM. 


If you want to change just the ^R codes to commas or tabs, use 
this macro: 


STRIPR.WPM (CHAP14 directory on Applications Disk) 
(DISPLAY OFF) 


(Home) (Home) (Up) 
(Replace}Jn(Merge R) 
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{Search), (Search) 
(DISPLAY ON} 


Change the comma in the Replace With: string with a (Tab) code 
as required. Before and after examples of converted secondary merge 
documents are shown in Figures 14—14 and 14-15. 


Converting Tab-delimited Files to Secondary 
Merge Files 


This macro converts tab-delimited files into standard secondary 
merge document format, adding a “R code to separate each field (the 
AE record code is not added). 


STRIPTAB.WPM (CHAP14 directory on Applications Disk) 
{DISPLAY OFF) 
(Home}({Home} (Up) 
{Replace)n{Tab} 
(Search}{*R) (Enter) (Search) 
(DISPLAY ON) 


The tabs should already be converted to [Tab] codes. If the docu- 
ment uses spaces instead of tabs, use the SPTOTAB.WPM macro 
detailed earlier in this chapter. 


Converting Comma-delimited Files To Secondary 
Merge Files 


This macro converts comma-delimited records into standard secon- 
dary merge document format, adding a ^R code to separate each field 
(the “E record code is not added). 
STRIPCOM.WPM (CHAP14 directory on Applications Disk) 
(DISPLAY OFF) 
{Home} {Home} {Up} 
(Replace}n, 
(Search) (*R) (Enter) (Search) 
(DISPLAY ON) 
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Adding ^E and ^R Merge Codes to Tab Delimited 
Files 


CONVERT.WPM macro adds the “E code at the end of each record 
and “R codes at the end of each field. If you use this macro, don’t use 
STRIPTAB.WPM or STRIPCOM.WPM. 


CONVERT.WPM (CHAP14 directory on Applications Disk) 
(DISPLAY OFF) 
(Home}(Home) (Up) 
(Replace)n{Enter) 
(Search) (^R) (Enter) (^E) (Enter) (HPg) (Search) 
(Home}(Home} (Up) 
(Replace}n) (Tab) 
(Search) (^R) (Enter) (Search) 
(DISPLAY ON) 


CHAPTER 15 
ACRO POTPOURRI 


P onder the situation long enough and you can construct a macro 
for just about anything. This chapter is devoted to those macros that 
don’t squarely fit into any particular category but are, nonetheless, 
functional and practical. A few of the macros have nothing to do with 
word processing applications, but show that WordPerfect macros can 
be programmed to meet any challenge. 

In this chapter you'll find: 


eA type of "RAM resident" note pad; always ready to jot down a 
great idea and store it safely for future reference. 


e An electronic while-you-were-out pad that automatically stamps 
the time and date on phone messages you take for others, and 
records each message in a separate name file. 


e An on-screen calculator that lets you enter simple equations and 
calculate the results. 


eA multiple-choice quiz game, where you determine the questions 
and answers. 
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eA message generator that displays a different proverb or saying 
every time you start WordPerfect. 


¢Miscellaneous document macros for such things as printing docu- 
ments backwards, sorting lists, and maintaining data files. 


eA text-adventure game where you search through rooms looking 


for treasure and try to solve the riddle of "The City of a Thousand 
Terrors." 


NOTE PAD 


The note pad comes in two versions: switched and unswitched. The 
switched macro note pad uses Doc 2 as a scratch pad for the memo 
you want to write to yourself. If Doc 2 contains anything, it will be 
erased. 

If you regularly use Doc 2 for comparing documents or editing text, 
you ll want to use the unswitched macro note pad. WordPerfect uses 
the same document window you are currently viewing for the note 
pad, but the macro cleans up after itself leaving no trace of the 
memo. The disadvantage of the unswitched macro note pad macro is 
that it is not as "clean looking" as the switched version. Your original 
document stays on the screen and can be distracting while you are 
trying to write the note. 


Unswitched Note Pad Macro 


The unswitched note pad macro is most easily written from scratch 
from within the macro editing window. An example of the un- 
switched note pad is shown in Figure 15-1. Notice that the existing 
document is still shown on the screen. 


SCRMEMO.WPM (CHAP15 directory on Applications Disk) 

1. (DISPLAY OFF) 
(Home) (Left) 
(Enter) (Enter) (Enter) (Up) 

2.DATE/TIME: {Tab} (Date/Outline} 1-/- 
(Date/OutLIne}38:90(Enter) 1 
(Date/Outline)}33.1,.4(Enter)0{Enter) 
(Enter) 
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on the soundtrack. Press the zoom button and you hear the 
unmistakable uhir of the lens motor — only the close 
proximity of the motor makes the whir sound like a dentist’s 
drill. 


If the microphone on your camcorder is on a telescoping 
mount, extend it out all the way. This increases the distance 
betueen the microphone and you and the camcorder, reducing 
unwanted sounds. If the microphone is removable, take it off and 
mount it on a telescoping rod. Most camcorders have an accessory 
shoe that mates uith the base of the telescoping rod. 


DATE/TIME: July 93,1983 7 5:45pm 


SUBJECT: Idea for convention 


TEXT: How about a magician that stands in front of the booth 

and does outrageous card tricks to the delight of the 

conventioneers. The best part is the magician has a mean Penn g 

Teller streak, uhich should set him Cher?) apart from the 

hundreds of other card magicians that will be at the 

convenvention 

D: \UPS@\CAMSOUND Doc Z Pg 2 Ln 28 Pos 24 


FIGURE 15-1 UNSWITCHED NOTE PAD EXAMPLE 


3. (DISPLAY ON) 
SUBJECT: {Tab) (PAUSE) 
(Enter) (Enter) (Enter} 
TEXT: (Tab) 
4. (PROMPT)Write the memo text here; press Ctrl-Enter when 
done. - -~ 
5. {ASSIGN} 1~~ 
(LABEL) loop~ 
(IF EXISTS}1~(PROMPT) (DEL TO EOL)~ 
(ELSE) 
(END IF) 
(VAR 1) 
(LOOK)1~ 
(IF)"(VAR 1)"="(HPg)"~ 
(ELSE) (GO) loop~ 
(END IF) 
6. (Enter) {Enter} (Enter) (Enter) 
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(Search Left} DATE/TIME: {Search) 
(Home) {Left} (Left) (Left) 

Movel4 

MEMO.TXT (Enter) 

(Block) 

(Search}------ (Search) 

(Del}y (Down) {Up} {Del} 


eStep 1 temporarily turns the display off and moves the cursor to 
the far left margin, adds three empty lines, and moves the cursor 
up one line. The lines allow extra space above and below the memo 
while you are writing it. 


eStep 2 stamps the time and date (be sure to set the time and date 
in DOS if your computer doesn’t have a battery-backup clock). 


Step 3 turns the display on. The macro writes SUBJECT: on the 
screen, then waits for you to enter text. The macro then writes 
TEXT: on the screen. 


Step 4 prompts for the memo text. 


Step 5 is a loop that waits for you to press [Ctrl]-[Enter]. Upon 
pressing [Ctrl]-[Enter], the macro proceeds to Step 6. 


¢Step 6 selects the entire memo and appends it to a file called 
MEMO.TXT (WordPerfect creates the file if it doesn’t already 
exist). The last portion of the macro removes the extra spaces and 
closes up the original document as if nothing ever happened. 


The memo is stored in the MEMO.TXT. Each new note appends to 
the end of the previous note and is separated by the dashed line. To 


start with a new slate, periodically print the notes, then erase the 
file. 


Switched Note Pad Macro 


SWMEMO.WPM (CHAP15 directory on Applications Disk) 
1. (DISPLAY OFF) 
(Switch) (Exit}nn 
(Enter} (Enter) 
2. DATE/TIME: {Tab} {(Date/Outline}1./. 
(Date/Outline}38:90{Enter}1 
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{(Date/Outline}33.1,.4(Enter)0(Enter) 
{Enter} 
3. {DISPLAY ON) 
SUBJECT: (Tab) (PAUSE) 
(Enter) (Enter) (Enter) 
TEXT: (Tab) 
4. (PROMPT) Write the memo text here; press Ctrl-Enter when 
done. -~ 
5. (ASSIGN) 1~~ 
(LABEL) loop~ 
(IF EXISTS) 1~(PROMPT)(DEL TO EOL)~ 
{ELSE) 
(END IF) 
(VAR 1) 
(LOOK) 1~ 
(IF}"(VAR 1)"="(HPg)"~ 
(ELSE) (GO) loop~ 
(END IF) 
(DISPLAY OFF) 
6. {Enter} {Enter} (Enter) 
(Block} 
(Search Left} DATE/TIME: (Search) 
(Home) (Left) (Left) (Left) 
(Move) 14 
MEMO.TXT (Enter) 
(Ext)nn 
(Switch) 
(DISPLAY ON) 


eStep 1 temporarily turns the display off and switches to Doc 2, 
where it then clears the screen and starts with a new document. 
Step 2 stamps the time and date. 


eStep 3 turns the display on. The macro writes SUBJECT: on the 
screen, then waits for you to enter text. The macro then writes 
TEXT: on the screen. 

¢Step 4 prompts for the memo text. 


¢Step 5 is a loop that waits for you to press [Ctrl]-[Enter]. Upon 
pressing [Ctrl]-[Enter], the macro proceeds to Step 6. 


874 WordPerfect 5.0 Macros and Templates 


Step 6 selects the entire memo and appends it to a file called 
MEMO.TXT (WordPerfect creates the file if it doesn’t already 


exist). The last portion of the macro clears the screen and switches 
back to Doc 1. 


ELECTRONIC WHILE-YOU-WERE-OUT PAD 


How many times have you fumbled for a piece of paper and pencil in 
order to write down a phone message for yourself or someone else? 
This macro lets you write phone messages even when you are busy 
working on another job in WordPerfect. Messages for each person in 
your house or office are stored in a separate file—messages for you 
are in one file, messages for the boss in another file, and so forth. 
Phone messages for a person named "Roger" are shown in the ex- 
ample in Figure 15-2. Additional macros, shown below, let you print 
and delete phone message files. 

The phone message macro uses Doc 2 as a scratch pad. If neces- 
sary, rewrite the macro so that it uses the current document window 


FIGURE 15-2 PHONE MESSAGE EXAMPLE 


Date: July 9, 1389 Time: 3:S3pm 
To! Roger 

Person calling: Bill Davis 

From! Anderson Gear 


Message: Wants to talk to you about the press kit photos. 
Notes: Call back ASAP 


Date: July 9, 1989 Time: 2:24pm 
Tot Roger 

Person calling: Carol G. 

From: West Valley Copier 


Message: Your order for copier toner is in. 
Notes! 


Date: July 18, 1989 Tins: 10:38am 
To: Roger 


Person calling: Uife 
From: 


Message! Kids are sick today. 
Notes: Can you come home for lunch. 


D:\UPS@\PHONE\ROGER, PHN 


Doc 1 Pg 1 Ln 22 Pos 18 
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but cleans up after itself when finished. The note pad macros, 
presented above, show how this is done. 

Important Note: The WHILEOUTWPM and WHILOUT1.WPM 
macros are designed to store phone messages in a directory named 
PHONE. If this directory does not already exist on your work disk, 
WordPerfect will report an Access Denied message. You can: 


“create the phone directory 


°rewrite the macro so that it does not use a directory to store the 
phone messages. 


WHILEOUT.WPM—Phone Message Macro (CHAP165 directory 
on Applications Disk) 

1. (Switch) 

(Exit}nn 

2. {TEXT)1~Who is the call for?: ~ 
(TEXT) 2~What is the name of the person calling?: -~ 
(TEXT)}3~From what company/organization?: -~ 
(TEXT)4~What is the message? (up to 120 chars.): ~ 
(TEXT)5~Will call back/please call/other comments. - -~ 
(DISPLAY OFF) 

3. Date:.(Date/Outline}33.1,.4(Enter)1. =- 183.. 
Time:.{Date/Outline)38:90(Enter) 1 (Enter) 
(Date/Outline)33.1,.4(Enter)0 

4. To:.(VAR 1)(Enter) 
Person Calling:.{VAR 2) ({Ænter) 
From:.({(VAR 3) (Enter) 
Message:. (VAR 4) (Enter) 
Notes:.(VAR 5} (Enter) 
(Enter) (Enter) 

5. (Home) (Home) (Up) 
{Block) {Home} (Down) 
(Move) 14PHONE\ (VAR 1).PHN (Enter) 
(Exat}nn 
(Switch) 
{DISPLAY ON) 


¢Step 1 switches to Doc 2 and clears it. 


eStep 2 asks questions about the call and stores the answers in 
variables 1 through 5. 
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«Step 3 stamps the current date and time (from DOS). If you don't 
use the DOS clock, rewrite the memo so you can enter the time 
and date manually. 


¢Step 4 prints the contents of the variables in the document. 


Step 5 selects the entire message and appends it to a file 
(NAME}.PHN, where (NAME) is the first eight characters of the 
person’s name you entered into variable 1. After the message has 
been appended, the macro clears the screen and returns to Doc l. 


The macro stores phone messages in a subdirectory called 
PHONE. The subdirectory keeps the phone message files from clut- 
tering up the main WordPerfect directory. You may delete the sub- 
directory if you wish or use one with another name, but be sure to 
modify the macro accordingly. 


Alternative Phone Messages Macro 


This alternative phone message macro lets you redo a message if 
you accidentally enter incorrect information. See the note in the pre- 
vious section for WHILEOUT.WPM on the use of the phone direc- 
tory 


WHILOUTLWPM (CHAP15 directory on Applications Disk) 

1. (Switch) 

(LABEL) loop~ 
(Exit}nn 

2. {TEXT)1~Who is the call for?- -~ 
(TEXT}2~What is the name of the person calling?: -~ 
(TEXT)3~From what company/organization?: ~ 
(TEXT}4~What is the message? (up to 120 chars.) -~ 
(TEXT)5~Will call back/please call/other comments. - -~ 
(DISPLAY OFF) 

3. Date:.(Date/Outline)33 1, 4{Enter)1.-------- 
Time:.{Date/Outline)38:90{Enter)}1(Enter) 
(Date/Outline)33.1,.4({Enter)0 

4. To:. (VAR 1}{Enter} 

Person Calling:. (VAR 2} {Enter} 
From:.(VAR 3) (Enter) 
Message:.{(VAR 4}{Enter) 
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Notes:.(VAR 5) (Enter) 
(Enter) (Enter) 
5. {CHAR})7~Is everything correct?.(y/n).~ 
(TF)"(VAR 7)"="y"~ 
(ELSE) (GO) loop~ 
(IF)"(VAR 7}"="Y"~ 
(ELSE) (GO) loop~ 
(END IF) (END IF) 
6. (Home) (Home) (Up) 
(Block) (Home) (Down) 
{Move} 14PHONE\ {VAR 1).PHN (Enter) 
(Exit}nn (Switch) 
(DISPLAY ON) 


PRINTPHN.WPM—Print Phone Messages Macro (CHAP15 
directory on Applications Disk) 

The PRINTPHN.WPM macro expects the phone messages to be in- 
cluded in a directory named PHONE. If your messages are not there, 
rewrite the macro accordingly (take out the "PHONE" instruction in 
the List File3 line). 


1. (CHAR) 1~Print ALL messages or selected messages? (Enter A 
for ALL or S for SELECTED): -~ 
(IF)" (VAR 1)"="A"~(GO)printall~ 
(ELSE) (IF)"(VAR 1)"="a"~{GO)printall~ 


(ELSE) 
(IF)"(VAR 1)"="S"~(GO)printsome~ 
(ELSE) 
(IF)" (VAR 1)"="s"~(GO}printsome~ 
(ELSE) 


(END IF) (END IF}(END IF)(END IF) 
2.(LABEL})printall~ 
{List Files} (End) (Left) (Left) (Left) phone \ (Enter) 
92To:(Enter} 
4y (QUIT) 
3. (LABEL}printsome~ 
(List Files) (End) (Left) (Left) (Left)phone\ (Enter) 
(PROMPT) (“R)Select a message file to print and press 4, then 
Enter. -~ 
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¢Step 1 asks if you want to print all messages, or just selected ones. 
Pressing A or a jumps the macro to the "printall” routine; press- 
ing S or s jumps the macro to the "printsome’ routine. 


¢Step 2 is the "printall" routine that prints all the documents in 
the PHONE subdirectory. If you don’t use a subdirectory, separate 


the phone message files from the rest using the .PHN file exten- 
sion. 


¢Step 3 is the "printsome" routine. The macro actually ends after 
the (PROMPT) instruction; you finish the print process by select- 
ing a file, pressing 4, then hitting [Enter]. 


DELPHN.WPM—Delete Phone Messages Macro (CHAPI15 
directory on Applications Disk) 

Like PRINTPHN.WPM, this macro expects the phone messages to 
be included in a directory named PHONE. If your messages are not 
stored there, rewrite the macro accordingly. 


1. (BELL) 

{CHAR} 1~Delete all messages or selected messages? (enter A for 
ALL or S for SELECTED). -~ 

([F)"(VAR 1)"="A"~(GO)delall~ 
(ELSE) 
(F)"(VAR 1)"="a"~(GO)delall~ 
(ELSE) 
(IF)" (VAR 1)"="S"~(GO)delsome~ 
(ELSE) 
IF)" (VAR 1)"="s"~(GO}delsome~ 
(ELSE) 


(END IF}(END IF) (END IF)(END IF) 
2. (LABEL)delall~ 
(List Files) (End) (Left) (Left) (Left)phone\ (Enter) 
92To:(Enter) 
2y (QUIT) 
3. (LABEL)delsome~ 
{List Files) (End) (Left) (Left) (Left) phone \ (Enter) 
{PROMPT} (“R)}Select a message file to print and press 2. - -~ 


*Step 1 asks if you want to delete all messages or just selected ones. 
Pressing A or a jumps the macro to the “delall" routine; pressing 
S or s jumps the macro to the "delsome" routine. 
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oStep 2 is the "delall" routine that deletes all the documents in the 
PHONE subdirectory. If you don’t use a subdirectory, separate the 
phone message files from the rest using the .PHN file extension. 


oStep 3 is the "delsome" routine. The macro actually ends after the 
(PROMPT) instruction; you finish the deletion process by select- 
ing a file, then pressing 2. 


QUICK CALCULATOR 


Unlike some word processors, WordPerfect lacks a separate 
keyboard entry calculator. In order to perform ordinary math cal- 
culations with WordPerfect—addition, subtraction, multiplication, 
and division—you must set up a math definition, turn math on, then 
enter the numbers in the proper columns. A handheld pocket cal- 
culator is easier, even if you have to root through your desk to find 
it. 

But the QUIKCALC.WPM macro takes some of the hassle out of 
direct keyboard calculations. It first sets up a temporary math 
definition in Doc 2, then asks you to enter the numbers and calcula- 
tion operator. The results are shown on the screen, as illustrated in 
Figure 15-3. 


QUIKCALC.WPM (CHAP15 directory on Applications Disk) 
1. (DISPLAY OFF) 
(Switch) 
2. (LABEL)}start~ 
(Exit)nn 
(Math/Columns)2 
{Right} (Right)1 
(Right) (Right) {Right} (Right)0 
3. (TEXT) 1~Enter the first number; press Enter. - ~ 
(CHAR)2~Enter the math operator (+, -, *, N -~ 
(TEXT)3~Enter the second number, press Enter. : ~ 
4. A(VAR 2) E (Exit) (Exit) 
1 
5. (Tab) (VAR 1) 
(Tab) (Tab) (VAR 2) 
(Tab) (Tab) (VAR 3) 
(Tab) (Tab) (Tab) 
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2,398 A 34.7 83,218.68! 


Do another (y/n). _ 


FIGURE15-3 QUIKCALC CALCULATIONS IN DOC 2 


6. (Math/Columns)}2 
(DISPLAY ON) 
7. (LABEL) loop~ 
(CHAR)4~Do another? (y/n). -~ 
(IF)"(VAR 1)"="y"~(DISPLAY OFF) (GO)start~ 
(ELSE) 
(IF)"(VAR 1)"="Y"~(DISPLAY OFF) (GO)start~ 
(ELSE) 
(IF)"(VAR 1}"="n"~{GO)finish~ 
{ELSE} 
(IF) (VAR 1)"="N"~(GO}finish~ 
(ELSE) 
{END IF) (END IF END IF) (END IF) 
(PROMPT)}Press y or n. - -~ (BELL) (WAIT}15~(GO)loop~ 
8. (LABEL)finish~ 
(DISPLAY OFF) 
(Œxit)nn 
(Switch) 
(DISPLAY ON} 
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°Step 1 turns the display off and switches to Doc 2. 


°Step 2 clears the screen and sets up the preliminary math defini- 
tion. 


o Before the definition is complete, the macro asks you in Step 3 to 
enter the first number of the calculation (stored in variable 1), the 
operator (stored in variable 2), and the second number (stored in 
variable 3). 


°In Step 4, the text in variable 2 is used to complete the math 
definition. 


°Step 5 enters the values from variables 1, 2, and 3 in their proper 
columns. 


°Step 6 calculates the figures and turns the display back on. 


°Step 7 asks if you want to do another calculation or quit. Press- 
ing y or Y brings you back to the "start" label; pressing n or N 
jumps the macro to the "finish" routine. 


°Step 8 is the "finish" routine. The macro turns the display off, 
clears the screen, switches to Doc 1, and turns the display back 
on. 


QUIZ GAME 


The quiz macro is an engine that you can use with any ques- 
tion/answer sheet you want to devise. An example of a ques- 
tion/answer sheet is shown in Figure 15—4. To work properly, your 
question/answer sheet must be formatted the same way. The docu- 
ment should use single spacing between all lines, and the answer for 
the previous question must start with the @ character. The @ charac- 
ter cannot be used in any other part of the text (you can change the 
character if you wish, but you must modify the QUIZ.WPM macro to 
do so). The end of the answer is identified by the “ caret symbol. The 
^ symbol cannot be used in any other part of the text. All questions 
must be numbered consecutively, starting at 1. 

The question/answer document, called ANSWERS.TXT, can be 
any length and you can ask as many questions as you want. The 
macro is set up for multiple choice answers with five possible selec- 
tions, but you can modify the macro to accept any type of question 
and answer format. 
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QUIZ.WPM (CHAP15 directory on Applications Disk) 


i 


bo 


4. 


(ep) 


(ON NOT FOUND) {(GO}quit~ 
(ASSIGN)2~1~ 

(ASSIGN]3~0~ 

{ASSIGN} 4~0~ 

(DISPLAY OFF) 

(Retrieve) ANSWERS.TXT (Enter) 


. {LABEL)start~ 


{Search} (VAR 2) (Search) 

{Block} 

{Search)@{Search} 

(Left) (Left) (Move} 12 

(Switch) 

(Enter) (Home) (Down) (End) (Enter) (Enter) 


. (DISPLAY OFF) 


(Switch) 

(Search)@ (Search) 

(Right) (Block) (Right) (Macro Commands} 30 
{Left} (Block) 

(Search)“ (Search) 

{Left} (Move}12(Cance}]} 

(Switch) 

{DISPLAY ON} 

(LABEL) question~ 

(CHAR) 1~Enter your choice. - -~ 
TE)"(VAR 1)"="(VAR 0}"~(GO)}correct~ 
{ELSE){GO)incorrect~ 

{END IF) 


. (LABEL)correct~ 


(DISPLAY ON} 

That is correct.(Enter} 
{(Move}41 

(WAIT}50~ 
(ASSIGN}3~[(VAR 3)}+1~ 
(GO)}count~ 


. {LABEL}incorrect~ 


{DISPLAY ON) 

(BELL) 

That is incorrect.{Enter} 
{Move}]41 
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1 Who was the first president of the United States? 
Abraham Lincoln. 
George Washington. 
Grover Cleveland. 
Richard Nixon. 
None of the above. 
@ The first president of the United States was George 
Washington. ^ 
What is the second element in the periodic table of 


NODWN 


elements? 
Lis Argon. 
2a Hydrogen. 
3 Water. 
4. Helium. 
5. None of the above. 
@ 4 The second element in the periodic table of elements is 


Helium. ^ 

3 What is Donald Duck’s middle name? 

Roger. 

Dewey. 

Fauntleroy. 

Walt. 

No middle name. 

Donald Duck’s given middle name is Fauntleroy. ^ 
he IQ test was developed by: 

Albert Einstein. 

Ronald Reagan. 

Claude Moore. 

Alfred Binet. 

None of the above. 

@ The IQ test was developed in about 1896 by French 
psychologist Alfred Binet. ^ 

5 The IBM PC was officially unveiled in what year? 
1975. 

1979. 

T981; 

1886. 

None of the above. 

. The PC was introduced by IBM in August of 1981. ^ 


H= 


A @ 
Loh WNr AWD Wh 


Woh WHF 


FIGURE 15-4 QUIZ GAME QUESTION/ANSWER SHEET 
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{(WAIT}50~ 
(ASSIGN) 4~(VAR 4)+1~ 
(GO)count~ 
7. (LABEL) count~ 
(DISPLAY OFF} 
(Exat}nn 
(ASSIGN)2~{VAR 2)+1~ 
(Switch) 
{GO)start~ 
8. (LABEL) quit~ 
(ASSIGN}5~(VAR 2)-1~ 
{Exat)nn (Switch) (Exit)nn 
(IF) (VAR 3) (VAR 4)~Congratulations!. - 
(ELSE) 
(END IF) 
Out of (VAR 5) questions, you got:{Enter) {Tab} (VAR 3) 
questions answered correctly. (Enter) 
(Tab) (VAR 4} questions answered incorrectly. 
(Enter) 


Step 1 tells the macro to go to the "quit" routine when a search 
ends in *not found*. Assuming that the ANSWERS.TXT docu- 
ment is formatted properly, the only time this should happen is 
when all the questions have been asked. The step also enters 
values into variables 2, 3, and 4, turns the display off, and 
retrieves the ANSWERS.TXT question/answer document. 


¢Step 2 marks the beginning of the main routine of the macro. It 
searches for each question by number, starting with number 1 (the 
initial value in variable 2). The macro then copies the question, 
switches to Doc 2 (where the questions are shown), and pastes it 
into the document. 


Step 3 turns the display off (it is turned on in later routines), 
switches back to Doc 1 and the question/answer document, then 
copies the correct answer number into variable 3 (using the 
"(Macro Commands)30" instruction). The macro then copies the 
entire answer and switches back to Doc 2. 


eStep 4 displays the prompt, “Enter your choice." If the number 
you press corresponds to the value in variable 3, the answer is cor- 
rect and the macro jumps to the "correct" routine. Any other key 
press jumps the macro to the "incorrect" routine. 
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eStep 5 is the "correct" routine. The macro displays "That is cor- 
rect," then pastes the answer from the buffer into the document. 
After a five-second delay, the macro adds 1 to variable 3 (the 
answered right counter), then jumps to the "count" routine. 


oStep 6 is the "incorrect" routine. The macro beeps and displays 
“That is incorrect." It then pastes the answer from the buffer into 
the document. After a five-second delay, the macro adds 1 to vari- 
able 4 (the answered wrong counter), then jumps to the "count" 
routine. 


oStep 7 is the "count" routine. It counts the number of questions so 
that the macro always knows which question is next in line. At 
the end of the routine, the macro jumps back to the "start" label, 
and the question/answer process is repeated 


oStep 8 is the "quit" routine, which runs when there are no more 
questions. The macro first subtracts 1 from variable 2 (questions 
asked counter) and assigns the number to variable 5 (subtracting 
1 from variable 2 is necessary to keep the tally correct). The macro 
then clears both document windows. If the value in variable 3 
(answered correct) is larger than the value in variable 4 (answered 
incorrect), the macro displays a "Congratulations" message, then 
shows the number of questions you got right and wrong. When the 
value in variable 3 is the same or smaller than in variable 4, the 
“Congratulations” message is left out. 


An example of one of the questions is shown in Figure 15-5. If you 
plan on creating many quiz games, make copies of the quiz macro. 
Give the copies easily identifiable names. Change the file name after 
the (Retrieve) instruction to match the question/answer document 
you are using. 

Steps 5 and 6 include a timing loop that keeps the answer on the 
screen for five seconds before the macro turns the display off and 
flashes the next question on the monitor. Increase the time delay if 
you want the answers displayed longer. 

Alternatively, you can wait for the user to press a key before con- 
tinuing. Rewrite steps 5 and 6 as follows; 


5. {LABEL}correct~ 
{DISPLAY ON} 
That is correct.{Enter} 
(Move) 41 
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hat is Donald Duck’s middle name? 


u 

1 Roger. 

Z. Deuey. 

3 Fauntleroy. 

4, Ualt. 

5. No middle name. 


That is correct. 
3. Donald Duck’s given middle name is Fauntleroy. 


Doc 2 Pg 1 Ln 9 Pos 190 


FIGURE 15-5 SCREEN WITH QUESTION AND ANSWER 


(CHAR}9~Press any key to go on. - -~ 
(ASSIGN)}3~(VAR 3)+1~ 
(GO)count~ 
6. (LABEL)incorrect~ 
(DISPLAY ON) 
(BELL) 
That is incorrect. {Enter) 
(Move)41 
(CHAR)9~Press any key to go on. : -~ 
(ASSIGN) 4~(VAR 4)+1~ 
(GO) count~ 


The modified quiz, with the {CHAR} instruction instead of the 
(WAIT) instruction, can be found on the Applications Disk as 
QUIZ1.WPM. 
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PROVERB MAKER 


Tired of starting WordPerfect and staring at a blank document? This 
proverb maker macro displays a timely saying at the bottom of the 
screen every time you start WordPerfect. The sayings are stored is a 
proverb file (appropriately named PROVERB.TXT). You can have 
any number of sayings in the file and they will repeat when the 
macro has gone through the entire list. 

The macro uses the /M-macro startup option to run automatical- 
ly when WordPerfect first loads. Rather than typing "WP /m- 
proverb" each time you want to start WordPerfect, include the 
startup option in a batch file. You can name the batch file anything 
you like as long as it doesn’t conflict with another batch file or the 
name of a program. For example, you can name the batch file 
WPBAT.BAT, but not WP.BAT (WP.EXE is the name of Word- 
Perfect). 

To make the batch file, be sure you are in the same directory as 
WP.EXE, and enter the following in DOS: 


COPY CON: WPBAT.BAT [ENTER] 
WP /M-PROVERB [ENTER] 

[F6] 

[Enter] 


PROVERB.WPM and PROVERB.TXT must be on the default drive 
and directory or WordPerfect won't be able to find them. You can, of 
course, place them in another drive or directory, but you must modify 
the batch file and macro accordingly. 

The format of PROVERB.TXT, which contains the actual 
proverbs, is simple: 


¢Single-space all lines. 
¢Place one proverb per line. 
e Add a hard return to separate each proverb. 


¢Make sure there are no blank lines at the top or bottom of the 
document. However, the last proverb must end with a hard return. 


Initially, place an @ symbol immediately before the text of the first 
line, as shown in Figure 15-6. This symbol is used by the macro as 
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@Hnemosyne — Goddess of memory and mother by Zues and the nine 
MUSES. 


Laus — The king of Thebes. 
Krishna — The black one; one of the greatest of Hindu dieties. 


gryphon — An animal with the body of a lion, head and wings of 
an eagle. 


Harpies — Winged monsters, half-uoman, half-bird. 


D: \UPSG\TEXT\ PROVERB. TXT Doc 2 Pg 1 Ln 1 Pos 18 


FIGURE15-6 PROVERB.TXT DOCUMENT WITH @ CHARACTER 


a place marker for identifying the next proverb to use. The @ sym- 
bol moves down one line each time the macro is activated. 


PROVERB.WPM (CHAP15 directory on Applications Disk) 

1. (DISPLAY OFF) 

(Exit}nn 

{Retrieve} PROVERB.TXT{Enter) 
2. (Search) @(Search) 

(Backspace) 

(ON NOT FOUND)(GO}special~~ 
3. {LABEL}start~ 

(Block) 

(Search) {Enter} (Search) 

@ 

(Macro Commands}31 

(Save) PROVERB.TXT({Enter}y 

(Exat)nn 
4. (DISPLAY ON) 

PROMPT{(VAR 1)~ 
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(DISPLAY ON) 
(QUIT) 
5. (LABE L)special~ 
(Block) 
(Home) (Home) (Home) {Up} 
(GO)start~ 


°Step 1 turns the display off and, as a precaution, clears the screen. 
The macro then retrieves PROVERB.TXT. 


° Step 2 searches for the @ place mark character. When found, it 
backspaces over it to erase it. If a search ends with a *not found* 
message, the macro is told to go the "special" routine. 


°Step 3 copies the proverb and places it into variable 1. A new @ 
character is placed at the beginning of the next proverb. The 
modified PROVERB.TXT file is saved and the screen is cleared. 


°Step 4 turns the display on and prints the message in the status 
line. The message remains until you start typing. 


°Step 5 is the "special" routine, which recycles the proverbs once 
they have all been displayed. It forces the cursor back to the begin- 
ning of the document where the first proverb is recorded in vari- 
able 1 and a new @ place mark character is placed in the next line. 


Of course, you are not limited to proverbs. You can use classic max- 
ims such as Murphy’s Laws, old almanac sayings, fortunes ("You will 
meet a tall, dark macro"), even proclamations of company policy. 


MISCELLANEOUS DOCUMENT MACROS 


In the course of writing this book, I developed numerous miscel- 
laneous macros designed to make writing and editing easier. These 
don’t strictly fit into the categories defined by the other chapters, so 
this is as good a place for them as any. 


Automatic Leader Dots For Your Own Lists 


TABLEAD.WPM prints a line of leader dots and the current page 
number in the right margin. Type any text over the dots and edit the 
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number as needed. The text, number, and leader dots are inde- 
pendent of the current margin or tab settings, so they will always 
align perfectly with the rest of your document. 

The macro needs a special file called RIGHT.FMT to work. The 
document includes a blank dot leader definition. Follow these steps 
to create the document: 


Key Sequence What it Does 

1. [Alt]-[F 5] Chooses Mark Text menu. 
2.5 Selects Define option. 
3.215 Defines list. 

4, aa Enters temporary word. 

5. [Alt]-[F'4] Turns block on. 

6. [Left] [Left] [Left] | Moves cursor back. 

7. [Alt]-[F5] Chooses Mark Text menu. 
8.21 Marks list. 

9, [Del] [Del] [End] Deletes temporary word. 
10. [Alt]-[F5] Chooses Mark Text menu. 
11.65y Generates table. 


Place the cursor on the [Flsh Rt] code and turn block on. Move the 
cursor until it rests just after the [C/A/Flrt] code. Then: 


Key Sequence What it Does 

1. (Ctrl]-[F'4] Chooses Move menu. 

2.41 Selects Append Block option. 
3. RIGHT.FMT Names file to Append to (file 
[Enter] does not exist yet) 


Here is the macro for use with the RIGHT.FMT file. 


TABLEAD.WPM (CHAP15 directory on Applications Disk) 
(Retrieve, RIGHT.FMT (Enter) 
(PAUSE) (Word Right)(Del) (Left) 
(PAUSE) (Word Right) (Right) (Enter) 


The TABLEAD.WPM macro calls up the RIGHT.FMT document 
and places the cursor at the start of the dot leaders. Type text and 
press [Enter]. The macro now erases the original page number and 
places the cursor there. Type a number of your own, then press 
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Introduction . . s. a s e e s ee 
Macro Primer... ‘ 

Learning Advanced Macros 

Macro Editing. 

Macro Programming 

Macros and Merges in Menus 

Using Templates with Macros 

Using Styles... x 
Letters and Memos. ; 

Boilerplate Business Correspondence. 


D: \UpSB\ TEXT\RIGHT. FMT Doc Z Pg 1 Ln 10 Pos 45 


FIGURE 15-7 LIST MADE WITH TABLEAD.WPM 


[Enter]. You can repeat the macro as many times as you like to 
create a table of contents such as that shown in Figure 15-7. 


Level 1 Paragraph Numbering 


Here is a macro that automatically numbers the next paragraph you 
type. It’s useful when writing numbered lists, some screenplays, and 
instruction manuals. As long as you don’t define a new paragraph 
numbering style, WordPerfect will consecutively number those 
paragraphs that have a [Par Num] code in front of them. This macro 
treats all paragraphs as level 1. 


PARNUM.WPM (CHAP15 directory on Applications Disk) 
(DISPLAY OFF) 
(Left Mar Rel) 
{(Date/Outline)51(Enter} 
(Tab) 
(DISPLAY ON) 


The {Left Mar Rel) code is created by pressing [Shift]- [Tab]. 
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Manual Level Paragraph Numbering 


Instead of numbering each paragraph at level 1, this macro lets you 
assign whatever level you want. 


PARNUMLWPM (CHAP15 directory on Applications Disk) 
(DISPLAY OFF) 
(Left Mar Rel) 
(Date/Outline}5(Enter) 
(CHAR)1~Enter the level number. - -~ 
(VAR 1}(Enter} 
(Tab) 
{DISPLAY ON) 


Time Stamp Macro 


TIME.WPM stamps the document with the current time, as set by 
the DOS clock. 


TIME.WPM (CHAP15 directory on Applications Disk) 
(DISPLAY OFF) 
(Date/Outline}3 
8:90(Enter} 
1 
(DISPLAY ON} 


The macro inserts the time text into the document. If you want 
the time updated each time you print the document, press 2 after 
entering the time format. 


Date Stamp Macro 


DATE.WPM stamps the document with the current date, as set by 
the DOS clock. 
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DATE.WPM (CHAP15 directory on Applications Disk) 
(DISPLAY OFF) 
(Date/Outline})3 
3 1, 4{Enter} 1 
(DISPLAY ON} 


The macro inserts the date text into the document. If you want the 
date updated each time you print the document, press 2 after enter- 
ing the time format. The date format is in the conventional "January 
1, 1989" format. Select another format if desired. 


Counting Words 


This macro counts the number of words in the document. The macro 
requires that the speller files (WP(WP)EN.LEX) be available either 
on your hard disk or floppy disk. 


WDCOUNT.WPM (CHAP15 directory on Applications Disk) 
(DISPLAY OFF} 
(Spell) 
6 
{DISPLAY ON) 


Print Selected Pages 


WordPerfect doesn’t include a simple command to print a specific 
page or a page range of the current document you are editing (to do 
it you must save the document, then print it through the List Files 
command). This macro lets you easily print any range of pages of the 
current document. 


PRPAGE.WPM (CHAPI15 directory on Applications Disk) 
(TEXT)2~Enter the beginning of the print range. - ~ 
(TEXT)3~Enter the end of the print range. ~ 
{Home}{Home}) {Home} (Up) 

{ASSIGN)4~(VAR 2)-1~ 
{ASSIGN"5~(VAR 3)-(VAR 4)~ 
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{Esc} (VAR 4) (Page Down} 
Block 

(Esc) (VAR 5}(Page Down) 
(Print}y 


Quick Save 


SAVE.WPM is a quick save macro for saving the current document 
to disk. For ease of use, rename it ALTS.WPM so you can invoke it 
simply by pressing [Alt]-S. You must have already saved the docu- 
ment and named it before you can use this macro. 


SAVE.WPM (CHAP15 directory on Applications Disk) 
(DISPLAY OFF) 
(Save) (Enter}y 
(DISPLAY ON} 


List Macros 


Even if you regularly store macros on a separate disk or subdirec- 
tory, some will inevitably wind up in your default WordPerfect 
disk/directory. You can easily display only macro files using 
MACLIST.WPM (rename it to an Alt-letter key so you can call it up 
more easily). 


MACLIST.WPM (CHAP15 directory on Applications Disk) 
(List Files) 
* wpm 
(Enter) 


Clear Screen 


CLS.WPM clears the contents of the current document window. Be- 
cause this can cause irretrievable loss, the macro includes its own 
fail-safe warning. 


CLS.WPM (CHAP15 directory on Applications Disk) 
(DISPLAY OFF) 
(BELL) (BELL) 
(CHARJ0~(4R)Sure you want to clear the current document? 


(y/n)~ 
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(IF}"(VAR 0}"="y"~ 
(ELSE}(QUIT) 
{END IF) 

(Exit}nn 


Macro Starter 


This macro is a "macro starter," for use if your macros are on another 
disk or in another directory. To access a macro, use the macro 
starter, then type the name of the macro you want to use. You don’t 
need to enter drive names or directories. This starter macro assumes 
your macro files are stored in a subdirectory called "macros." To use 
the macro starter, press [Alt]-A. 


ALTM.WPM (CHAP15 directory on Applications Disk) 
(TEXT) 1~Type the name of the macro and press Enter. : -~ 
(Macro)macros\(VAR 1)}(Enter) 


Line Draw 


LINEHOR.WPM and LINEVER.WPM are useful when creating 
forms using WordPerfect’s Line Draw feature. LINEHOR.WPM lets 
you define the number of lines you want, their spacing, and their 
length. LINEVER.WPM draws vertical lines of a specific length. Be- 
cause you probably want to add vertical lines only at specific points 
in your form, LINEVER.WPM doesn’t prompt you for spacing or 
number of lines. 


LINEHOR.WPM (CHAP15 directory on Applications Disk) 
{ASSIGN}2~0~ 
(TEXT}1~How many lines?: -~ 
(TEXT}3~Length of each line? ~ 
(TEXT) 4~Spacing between each line?: -~ 
(LABEL) loop~ 
{DISPLAY OFF) 
{Screen}249—({Enter) (Esc) (VAR 3) (Right}6 
{Esc} (VAR 4) (Down}0 
(Esc) (VAR 83) (Left) 
(ASSIGN) 2~(VAR 2}+1~ 
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(IF) (VAR 1)=(VAR 2)~ 
(ELSE) (GO)loop~ 
(END IF} 


To obtain the — character, press [Ctrl]-2 3, 8 (Enter} 


LINEVER.WPM (CHAP15 directory on Applications Disk) 
{ASSIGN}3~0~ 
(TEXT) 1~How long for each line?. -~ 
(DISPLAY OFF) 
{Screen)49 (ENTER) (Esc) (VAR 1}(Down)6 
(Right) 0 
(Esc) (VAR 1)(Up) 


To obtain the | character, press [Ctrl]-2 3, 9 (Enter). 

The "Things I Gotta Do Today" form, shown in Figure 15-8, was 
created in about 60 seconds using LINEHOR.WPM and 
LINEVER.WPM. The specifications for the horizontal lines are: 


¢Number of lines: 20. 
eSpacing between lines: 2. 
«Length of each line: 65. 


The specifications for the three vertical lines are: 
¢Length of each line: 40. 


Another example of using the LINEHOR.WPM AND 
LINEVIEER.WPM macros is shown in Figure 15-9. The routing slips 
also use a box frame created with the following macro. Both the rout- 


ing slip and "Things I Gotta Do Today" forms are included on the Ap- 
plications Disk. 


Line Across 


Often, all you want is a simple line that stretches across the page 
from margin to margin. LINEACRS.WPM does it for you. It is set up 
for standard one-inch left and right margins, but by increasing the 
number in line 3 to, say 132, you can draw a line that will stretch 
across a 15-inch form. Even if the current margins don’t allow as 
many character positions as you have set, the line will stop when it 
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THINGS I GOTTA DO TODAY 
Description 


FIGURE15-8 THINGS I GOTTA DO TODAY FORM 
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ROUTING SLIP 
Date: 


Route To: 


a a LS 


When finished, cross out your name and 
pass on 


FIGURE15-9 ROUTING SLIP FORM 


reaches the right margin. Note, however, that the more unnecessary 
character spaces, the longer the macro will take to execute. Start the 
macro with the cursor at the left margin. 


LINEACRS.WPM (CHAP15 directory on Applications Disk) 
(DISPLAY OFF) 
(Screen)249—(Enter) 
(Esc) 65 
(Right) (Exit) 
(DISPLAY ON} 
(Right) 


To obtain the — character, press [Ctrl]-2 3, 8 (Enter) 


Box Draw 


This macro draws a box with the dimensions you specify. The macro 
uses WordPerfect’s Line Draw feature, so you must have a printer 
capable of printing the Extended IBM PC character set. 
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BOX.WPM (CHAP15 directory on Applications Disk) 
(TEXT) 1~Width of box? -~ 
(TEXT) 2~Length of box? -~ 
{DISPLAY OFF) 
{Screen 21}(Esc}{VAR 1)(Right) 
(Esc) (VAR 2} (Down) 
(Esc) (VAR 1) (Left) 
{Esc} (VAR 2) (Up) 
0 
(DISPLAY ON) 


A box with a length of 10 and a width of 20 is shown in Figure 15- 
10. Although the dimensions are not the same, the box is almost per- 
fectly square. The reason? WordPerfect’s uses character spaces for 
the width dimension and line spacing for the length dimensions. If 
you need to create a box of a particular dimension, either use 
WordPerfect’s graphic line draw feature or calculate the size using 
this formula (assuming 10 cpi printing settings): 


°Width = 10 characters per inch. 
°Length = 6 lines per inch. 


FIGURE15-10 SAMPLE BOX 


Length = 180 
lines 


Width = 20 
spaces 


Doc Z Pg 1 Ln 13 Pos 17 
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Printer Compatibility 


The Line Draw feature of WordPerfect uses the extended (above 
ASCII 128) character set of the IBM PC ROM. Not all printers are 
compatible with this character set, so if you format a document with 
Line Draw graphics, they may not appear on paper. The manual that 
came with your printer should tell you if it is IBM PC extended 
character set compatible. Also, be sure to choose the correct printer 
driver when installing WordPerfect. 

As long as your printer is capable of graphics (almost all formed 
character printers are, these days), and WordPerfect supports the 
printer with an appropriate driver, you can produce documents with 
all sorts of lines and boxes. But you must do so with WordPerfect’s 
graphic line drawing feature. See Chapter 10, "Desktop Publishing, 


for more information on using the graphics capabilities of Word- 
Perfect. 


To-do List 


The TODO.WPM macro lets you enter tasks that you must complete 
by a certain time or date, then go back and either erase tasks that 
are done or no longer required, or even move tasks around to 
reprioritize them. The macro automatically numbers each task for 
you. 

The macro uses a template document named TODO.TXT, shown 
in Figure 15-11. The formatting is displayed in the bottom half of 
the screen. A to-do list in construction is shown in Figure 15- 12. 


TODO.WPM (CHAP15 directory on Applications Disk) 
(Switch) 


{Exit}nn 

(Retrieve) TODO.TXT (Enter) 

(Home) (Home) (Down) (Up) 

(LABEL)start~ 

(Screen)0O 

(CHAR)0~What now?: -1 Add another item; 2; Prioritize; 3 Delete 
a task; 4 Print list; 5 Quit- -~ 

{CASE) (VAR 0}~ 
1~addmore~ 
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Things I Gotta Do Deadline 


2 CS TaT A Vents 


D: \UPSONTEXTNTODO. TXT Doc Z Pg 1 Ln 1 Pos 18 


C REDERI y AA oa O e Has í 
[Tab Set:@6°,8.5"°,6.S°JCPar Num DefICBOLDIJWhings I Gotta DolTablDeadlinelbold]CHR 


~ p ye SO eee J 


CHRE] 


Press Reveal Codes to restore screen 


FIGURE 15-11 TEMPLATE TODO.TXT DOCUMENT) 


FIGURE 15-12 SAMPLE TODO SCREEN 


Things I Gotta Do Deadline 


Wash the car Today 
Take out the trash Today 
Mou the laun Today 
Urite a book on WordPerfect macros Today 
Pick up mother—in-lau at airport Yesterday 
Watch the ball game TA 


Uhat nou? 1 Add more items; Z Prioritize; 3 Delete task; 4 Print List 5 Quit _ 
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2~prioritize~ 
3~delete task~ 
4~print~ 
5~quit~~(GO)start~ 
(DISPLAY OFF)(DISPLAY ON) 
(LABEL) addmore~ 
(PROMPT)Place the cursor to enter the new task and press 
Enter. - -~ 
(CALL) wait_enter~ 
(Left Mar Rel) (Date/Outline)51{Enter) 
(Enter) (Up) 
(PROMPT)Enter the task; press Enter when done. - -~{end) 
(CALL) wait_enter~ 
(GO)start~ 
(LABEL) prioritize~ 
(PROMPT)Position cursor on the task to move and press 
Enter. - -~ 
(CALL) wait_enter~ 
(Block) (End) (Move) 11(Cancel) (Del) 
(PROMPT) Position cursor at the new level and press Enter. -: 
(CALL) wait_enter~ 
(Enter) (Up) (Move}41 
(GO)start~ 
(LABEL) delete task~ 
(PROMPT) Position cursor on the task to delete and press 
Enter. -~ 
(CALL) wait_enter~ 
(DEL to EOL) (Del) 
(GO)start~ 
(LABEL) print~ 
(Print) 1(WAIT)30~ 
(GO)start~ 
(LABEL) quit~ 
(Save}TODO.TXT({Enter)y 
(Exit}nn 
{Switch} (QUIT) 
(LABEL) wait_enter~ 
(ASSIGN) 1~~ 
(LABEL)loop~ 
(VAR 1) 
(LOOK)}1~ 
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(CASE)"(VAR 1}"~ 
"(Enter}"~enter~ 
“(Up}"~up~ 
"{Down)'"~down~~(GO)}loop~ 

(LABEL}enter~ 

(RETURN) 

(LABEL)up~ 

{Home} (Left) 

(GO) loop~ 

(LABEL)down~ 

(Home) (Left}] 

(GO) loop~ 


To use TODO.WPM, start it and make a selection from the list. 
You must press numbers 1 through 5 or the menu prompt will 
remain. When adding another item, you are first asked to position 
the cursor at the spot where you want to add the task. Don’t forget 
to do this or you'll] throw the macro off track. Press [Enter] to sig- 
nal that you have made your choice, Enter a one-line task and, if 
desired, tab over to the Deadline column and enter a time or date. 
Press [Enter] when you are done and the menu prompt will reap- 
pear. 

To move a task, press 2, position the cursor on the line you want 
to move, and hit the [Enter] key. Next, place the cursor at the new 
spot and press [Enter] again. Deleting tasks involve the same basic 
steps as reprioritizing, except that you don’t choose a new location 
for the line. 

The to-do list is not foolproof and you may wish to add to it as your 
needs require. Avoid placing a task on the very last invisible line of 
the list or you won’t be able to add anything after it. The heavy line 
across the top uses the Line Draw feature of WordPerfect. Be sure 
your printer can accommodate it. The document TODO.TXT must be 
on the disk or the macro will not run. TODO.WPM uses Doc 2 as a 
scratch pad. If you have anything in Doc 2 when you execute the 
macro, yov’ll lose it. 


Record Sorter 


I needed a way to maintain my database of movies and rather than 
using a database program, or even an electronic spreadsheet with 
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database capabilities, WordPerfect’s merge feature seemed a good 
choice. But the problem with WordPerfect is that it requires you to 
go through numerous steps to do otherwise simple chores, such as 
resorting lists and updating records. A couple of macros changed all 
that. 

One example of my movie database lists Peter Sellers movies. 
Each field is separated by a ^R merge code and a hard return. Using 
WordPerfect’s sort feature, and sorting by paragraph (rather than 
by line), it’s possible to arrange the list using any of the fields as the 
primary key. The movies are initially sorted by date, but the sample 
macro presented below easily changes it to the last name of the direc- 
tor. 

Since all the movies in my collection share similar formatting in 
the database, I have developed a set of macros that sort on any of 
the first five fields (I also could have provided a one-line prompt 
menu in one master macro, as discussed in Chapter Five, “Macros 
in Menus and Merges," but I wanted to try it this way) 


SORTDIR.WPM—Sort Records by Director (Second Word in 
Second Line) (CHAP15 directory on Applications Disk) 

(Merge/Sort}2 

(Enter) {Enter} 

733a2(Enter) 

1(Enter} 

2(Enter) 

(Exit}1 


Secondary Merge File List Manager 


List maintenance using secondary merge files is fairly straightfor- 
ward for most tasks. New records are added at the end and the file 
is resorted as desired. Records can also be compared and acted upon 
using WordPerfect’s advanced sorting operators. But what if youjust 
want to delete a record? Normally, you’d have to take out every line 
manually (along with any errant codes), but this macro makes the 
job easy. As written, the macro looks for the pairing of ^E and [HPg] 
codes, as shown in Figure 15—13. Your secondary merge files should 
have the same format, or else you need to rewrite the macro. 
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Penny Points to Paradise*R 
Tony Young*R 

1951°R 

77 minutes*R 

b/uR 

Great Britian*R 

Harry Secombe*R 

Paddy O’Neil*R_ 

CE 


Doun Among the Z Men*R 
D:\UPSB\MI Doc 1 Pg 1 Ln 8 Pos 24 
Co e e ?} 


BT NNSA LA NAT oe LR Re la. 
Great Briti HRtJ 

Harry Secombe*R(CHRt] 

Paddy 0° Neil*RERERR 

“ECHPg] 

Doun Among the Z Men*RCHRt) 
Mcclean Rogers*“RCHRt) 
19S52*RCHRt) 

71 minutes*RCHRt) 
b/u“RCHRtI 

Great Britian” RCHRt] 


Press Reveal Codes to restore screen 


FIGURE 15-13 REVEAL CODES FORMAT OF SECONDARY FILE 


RECDEL.WPM (CHAPI5 directory on Applications Disk) 
(PROMPT) Move the cursor to the start of the record then press 
Enter. - -~ 
(ASSIGN) 1~~ 
(LABEL) loop~ 
(VAR 1) 
(LOOK) 1~ 
(IF)"(VAR 1)"=(Enter}"~ 
(ELSE) (GO}loop~ 
{END IF) 
{Block} (Search) (*E) {HPg) (Search) 
(Del}y 


Backwards Printer 


Don’t laugh—a macro that prints a file in backwards order is more 
useful than you think, particularly if you own an older model 
Hewlett-Packard LaserJet or Apple LaserWriter. Neither of these 
printers collates the pages in their proper order; the last page is on 
the top and the first page is on the bottom. If the print job is any 
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length at all, it means you have to go through the stack of papers 
and reshuffle them into their proper order. 

BACKPRI1.WPM goes through a document backwards, looking for 
the soft carriage return symbol that marks a page boundary. When 
it finds the [SPg] code, it stops to print the page. A special {ON NOT 
FOUND) exception handler prevents the macro from stopping 
prematurely when it gets to the top of the document and thus in- 
sures that the first page is printed. 


BACKPR1.WPM (CHAP15 directory on Applications Disk) 
(ON NOT FOUND})first page~~ 
(Home) (Home}{Down) 
(LABEL)search~ 
(Search Left} 

(AV) (Del to EOL) 
(Search) 

(Print)2 
(GO)search~ 
(LABEL}first page~ 
(Page Up) 

(Print}2 


Note that WordPerfect searches for the soft page break code, 
[SPg], using an undocumented feature. Pressing [Ctrl]-V, then 
[Ctrl]-[End] when WordPerfect displays the Srch: code enters [SPg] 
as the search string. In the macro, the code is (*V}{Del to EOL), but 
the result is the same. To enter the (4V}(Del to EOL) code in the 
macro, press these keys: 


[Ctrl]-V 
([Ctrl]-V 
[Ctrl]-V 
(Ctrl]-[End] 


The disadvantage to BACKPR1.WPM is that it searches for soft 
returns only. If you have inserted your own hard returns in the docu- 
ment by pressing [Ctrl]-[Enter], the macro will skip over those 
pages and not print them. Perhaps the best way to overcome this 
limitation is to search first for all the occurrences of [SRt] codes, then 


replace them with [HPg] codes. Also, rewrite the macro so that it 
looks for hard pages. 
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The rewritten version of the macro, BACKPR2.WPM, is shown 
here. Save the document just prior to printing. Unless you specifi- 
cally want the hard page codes, don’t save the document again once 
you have used the macro. 


BACKPR2.WPM (CHAP15 directory on Applications Disk) 
{ON NOT FOUND) {GO)start~ 
{Home} {Home} {Up} 
(Replace}n(4V) {Del to EOL) (Search) (HPg) (Search) 
(LABEL) start~ 
{ON NOT FOUND}first page~~ 
{Home}(Home}({Down} 
(LABEL)search~ 
{Search Left) 
(HP g) (Search) {Print}2 
{GO)search~ 
(LABEL)first page~ 
(Page Up] 
{Print}2 


Another version of a backwards printer macro is BACKPR3. WPM. 
This one requires some input on your part, but it prints all the pages 
no matter what kind of page break is used and it doesn’t modify the 
file. After starting the macro, you are asked the number of pages in 
the document. Enter that number and press [Enter]. The macro will 
do the rest. 


BACKPR3.WFPM (CHAP15 directory on Applications Disk) 
(ASSIGN) 0~0~ 
{TEXT)2~Please enter the number of pages in the document. - -~ 
{Home} {Home} {Down} 
(ASSIGN) 1~(VAR 2)-1~ 
{LABEL)count~ 
(IF) (VAR 0)=(VAR 1)~{Print}2(QUIT) 
(ELSE) (ASSIGN)0~(VAR 0)+1~(GO)print~ 
(END IF} 
(LABEL) print~ 
(Print}2 
(Page Up} 
(GO) count~ 
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ADVENTURE! 


WordPerfect certainly isn’t made as a tool for building adventure 
games. But with macros, it’s possible to construct interactive fiction 
macros that let you explore exotic, far-away places, hunt for 
treasures, and piece together mysterious riddles. To demonstrate 
some of WordPerfect’s macro features, I have developed a small, 
"skeleton" adventure game that consists of six rooms, sundry items 
to examine, pick up, and put down, and illustrative text to accom- 
pany the game play. 

The game system outlined here is just one approach of many to 
tackle the unique problem of interactive fiction and text adventures. 
There are many limitations and drawbacks of the system as 
presented; I leave it up to you to improve on the basic framework 
and expand the game any way you See fit. 

The reasons for developing and studying the game are manifold: 
First and foremost, it teaches you many unique aspects of advanced 
WordPerfect 5.0 macros. Many of the techniques used in the adven- 
ture game can be applied to other, more serious word processing ap- 
plications. Second, it helps you better understand how WordPerfect 
works, so you can master the features and operation of the program, 
whether or not you are creating or using macros. And third, it’s fun. 


Conventional Text Adventure Game Design 


Among the first text adventures for computers was a reasonably 
large and complex game called Dungeon, originally developed in the 
late 1970s for use on mainframe and mini computers. 

Although some adventure games deviate from the norm, most of 
them are modeled after Dungeon. The basic text adventure consists 
of several "rooms" which you, as the player, visit by entering com- 
pass directions (including up and down). 

In many of the rooms are objects that are meant as "keys" for solv- 
ing riddles or accomplishing some task later on. Some objects are 
painfully obvious—you don’t need to dig deep to find them. To make 
the game more difficult (and thus more enjoyable), some of the ob- 
jects are red herrings, and either serve no purpose at all or actually 
prevent you from completing the game. Dungeon, like most adven- 
ture games, allows you to collect only a certain number of objects at 
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any one time. These object are carried by you in an invisible back- 
pack. Most games call the backpack the "inventory." In fact, you can 
usually review the contents of the backpack by typing inventory. 
Objects carry a certain value (either positive or negative). This value 
contributes to your score. 

Dungeon was designed so that you scored whenever you picked up 
an object. The goal was to search all the rooms, unlock the various 
hidden treasures, and carry them out to a safe holding area. The 
more objects, the higher the score. The game also kept track of your 
turns. The more turns at the end of the game (if you got there at all), 
the lower your overall score. Some of the more advanced adventure 
games, these days, score on other criteria, such as rooms visited, puz- 
zles unlocked, demons or monsters defeated, and so forth. 

Although the conventional adventure game scenario is old and a 
bit tired, it serves as a good example of how to build your own. The 
object of your game is to have players search through rooms and dis- 
cover its objects. Some objects may be worthless, others may be ex- 
tremely valuable. 

The example adventure game presented in this chapter lacks a 
scoring mechanism, and none of its objects are used for anything. 
Rather, the game serves as a shell for your own further experimen- 
tation. Feel free to adapt the basic game by adding whatever fea- 
tures you feel will add tension and excitement. 

Because WordPerfect has room for only ten variables, you need to 
keep certain bits of information tucked away in a scratch pad docu- 
ment. The example adventure game, called "City of a Thousand Ter- 
rors" (for no particular reason), uses a document called 
ADVENT.TXT. The sole purpose of this document is to record the 
placements of the objects in the various rooms. You can easily add 
additional sections to the document and incorporate scoring 
mechanisms, tags, or keys that test if the player has accomplished 
some goal. 

All adventure games have a "parser" for communicating between 
the player and the computer. The parser breaks down phrases and 
even entire sentences and draws out those words that have meaning 
to the game. For example, entering "GO EAST" is broken by the par- 
ser into its component "GO" and "EAST" components. The parser is 
semi-intelligent, and the better the parser, the better the com- 
munication between game and player. 

WordPerfect’s macro feature does not lend itself well to building 
a sophisticated parser. Only exact text strings can be compared to 
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text values in an IF... .ELSE instruction, so typing "GO EAST" will 
not elicit the same response as simply typing "EAST." In fact, Word- 
Perfect macros are even case Sensitive, so entering "East" will not 
match with "EAST," "east," and other variations. 

Perhaps the next version of WordPerfect will contain a more 
liberal text string capability, but for now, you can counter most of 
the problems with a limited parser by providing a menu of possible 
commands. The menu can change as the player does different things. 
In the example adventure game presented here, the main menu 
presents the prompt: 


1 Look; 2 Get; 3 Drop; 4 Inventory 5 Examine; 6 Go; 7 Help 


—at the bottom of the screen. Pressing 6 (for Go) displays another 
menu, this one displaying: 


l East; 2 West; 3 North; 4 South 


You can add similar menus to other portions of your adventure 
game. For instance, you might include a rather large full-screen 
menu that offers suggestions for what to do with certain groups of 
objects. 


Game Pieces 


The WordPerfect macro adventure game consists of 11 macros. All 
are located in the CHAP15 directory on the Applications Disk. 


*ADVENT.WPM is the main adventure engine. All other macros 
nest from this one. 


*ROOM0O.WPM to ROOM5.WPM comprise the room macros. 
There is one macro for each room, and you can conceivably have 
as many rooms as you want. The room macros help WordPerfect 
keep track of the rooms you enter and exit. 


*LOOK.WPM displays descriptive text about the appearance and, 
the contents, if any, of the room. 


*EXAMINE.WPM allows you to examine, but not pick up, an ob- 
ject currently in a room. The macro displays some type of descrip- 
tive text about the object. 
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°GET.WPM lets you pick up an object currently in a room. That 
object is added to your inventory. 


°DROP.WPM removes any object from your inventory and places 
it in the current room. 


oINVENT.WPM displays the objects currently in your backpack. 


Not shown here is a separate HELP.WPM macro that provides 
helpful tips and possibly hints at solving the mystery of the game. 

The game requires the file ADVENT.TXT in order to keep track of 
the objects in each room. The ADVENT.TXT document is shown in 
Figure 15-14. Its format is fairly simple, but exact. After a blank 
space at the top, the document lists each room by number, then the 
objects that are in the room. The @ symbol is used as an end marker, 
helping WordPerfect know the boundaries of each room. The spac- 
ing between each room listing is not important. This document is 
modified during game play, but never saved by WordPerfect, so you 
may safely lock it against accidental erasure and over-writing 

All adventure games have maps that indicate the direction of 
travel from one location or room to another. The map for "City of a 
Thousand Terrors" appears in Figure 15-15. Each room is numbered 
for easy reference both by you and the game system. Note that you 
can only move in certain directions in each room. The ROOM# 
macros, controls the passage of movement from one room to another. 


Use of Variables 


The WordPerfect adventure game system, as presented here, uses 
four of the program’s ten possible variables. 


¢Variable O stores the players answers, including objects to get, 
drop, or examine. 

¢Variable 1 is the "current room counter," used to keep track of the 
room the player is currently in. 

¢Variable 4 is the "death counter," used to monitor the number of 
incorrect moves. When the "death counter" exceeds a certain limit 
(which you can set), the game is over. 


¢Variables 8 and 9 are miscellaneous counters. 
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knife 
crackers 
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ring 
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FIGURE 15-14 ADVENT.TXT DOCUMENT 


FIGURE 15-15 MAP OF GAME 
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You can use the remaining counters to keep score, to keep track 
of special objects, and more. Although this game system doesn’t work 
this way, it’s possible to store the digital equivalent of up to 16 ob- 
jects in each variable. Although the number stored in the variable is 
in decimal form, it can representa binary digit. For example, decimal 
number 8 is 1000 in binary form. 

Use binary counting to assign each item to a bit position. For ex- 
ample, out of the 16 bit binary number that can be stored in a vari- 
able (decimal 65,535), the knife can occupy position 1, the crackers 
position 2, and so forth. A macro you devise decodes the bit positions 
and turns them into objects. 

For more details on this topic, consult any book on programming, 
and refer to Chapter Three, "Macro Editing," and the Assigning 
Values to Variables section. 


CHAPTER 16 


MACRO STRATEGIES 


Tis chapter contains helpful tips, tricks, and shortcuts for work- 
ing with macros. You'll also find the many routines presented in the 
following pages beneficial when writing your own macros. 


CANCELING MACROS 


Unless otherwise indicated by the macro, or the text in this book, 
you may cancel macro execution by pressing [F1]. In most cases, this 
will not change the display on the screen. To make certain that you 
have terminated the macro, press [Ctrl]-[F10]. Ifyou see the "Define 
Macro" prompt on the bottom of the screen, all macro execution has 
been terminated. Press [F1] to cancel macro definition. 


NAMING AND STORING MACROS 


Any system of more than a few dozen macros cries out for some type 
of naming and filing scheme. If it takes you a minute or so to locate 
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the macro you need, then your name and storage system needs over- 
hauling. You may wish to adopt some or all of these techniques to 
easily and quickly locate the macro you need to use. 


Alt-Letter Macros 


Although it may be obvious, it’s worth repeating here: use Alt-letter 
combinations for those macros you access most often. Whenever pos- 
sible, choose a letter that mnemonically represents the macro. For 
example, use [Alt]-S for Save, [Alt]-P for Print, and [Alt]-R for 
Rewrite screen. Chances are that not all of your Alt-letter names will 
match the function of your macros. Until you can memorize all of the 
Alt-keys you have created, keep a list handy by your computer. 

It’s always a good idea to leave one or two Alt-letter keys open, in 
case you want to expand your macro system. If you find that you use 
a regular, named macro more often than you used to, you can always 
rename it with an Alt-letter combination. To do so, find the macro 
you want from the List Files directory. Select it and rename it 
ALT#.WPM, where # is one of the alphabet keys. For instance, 
ALTP.WPM is the macro file for [Alt]-P and ALTE.WPM is the 
macro file for [Alt]-E. 

By the same token, Alt-letter macros you no longer frequently use 
can be given file names. To change an Alt-letter macro, find its file 
in the List File directory and rename it. Remember to add the .WPM 
file extension or WordPerfect won’t know that it’s a macro. Remem- 
ber that nested and chained macros refer to other macros by name. 
If you alter the name of a macro that is used in a nested or chained 
instruction, be sure to modify all other macros that may be affected 
by the change. You can prevent problems later on by noting the par- 
ticulars of the construction of the macro in a macro log. You can’t 
use [Ctr]]- or [Alt]-number keys for macro names, but you can when 
you define macros as keyboard definitions. 


Named Macros 


The object of naming macros is to provide a name that’s short enough 
to allow you to type it quickly, but long enough so that its function 
is clear. DOS limits file names to no more than eight characters, 
which can lead to problems when trying to name your macros. Avoid 


Macro Strategies 417 


cryptic names or names that are too similar to others already in use. 
Borrow the naming techniques of the military and use acronyms and 
abbreviated forms whenever possible. Some examples: 


°XTRASP.WPM—For extra space macro, 


°WHILEOUT.WPM—While-you-were-out telephone message 
macro. 


°QUIKCALC.WPM—Quick on-screen calculator macro. 
°PARNUM.WPM—Paragraph numbering macro. 
°INDEXWRD.WPM—Index word macro. 


Some of the macros described in this book include a version num- 
ber, such as OUTLINE1.WPM, OUTLINE2.WPM, and so forth. 
These names were chosen to show you that the macros are similar 
to one another, but differ in features and capabilities. Once you have 
decided which of the various versions of the macro you want to use, 
rename it to make it easier to remember. 

Unusual named macros can be created using the Alt-number 
keypad. Use the IBM Extended Character Set, which is numbered 
between 128 and 255. To name a macro with a Character Set sym- 
bol, press the [Alt] key and type a number from 128 to 253. (Use the 
keypad, not the number keys, and don’t use characters 254 or 255.) 
Press [Enter] when done. Keep a list handy, referenced by Alt- 
keypad number (such as “Alt + 156") to remind you of the contents 
of each macro. 


Using Subdirectories 


Despite the best naming efforts on your part, a large macro library 
will become unusable if you don’t devise some way to classify the 
macros according to application. Use DOS subdirectories to sort out 
your macro collection. Refer to any book on DOS if you are not sure 
how to make and use subdirectories. 

Because the macros are in a subdirectory, you must enter the sub- 
directory name when calling the macro. Here’s an example of how 
you’d access a macro named CHAR.WPM (for script character for- 
mat) in a subdirectory called SCRIPT: 
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Key Sequence What it Does 

1. [Alt]-[F10] Invokes macro playback command. 

2. SCRIPT\CHAR Indicates subdirectory path and macro 
file name (subdirectory and file name 
separated by a backslash). 

3. [Enter] Runs the macro. 


Entering the subdirectory name each time you want to use a macro 
can be tedious, but you can avoid the extra keystrokes by writing 
short "subdirectory prefix" macros that automatically add the DOS 
path you want to access. Use Alt-letter names for convenience. For 
example, use [Alt]-S to start the SCRIPT subdirectory. After [Alt]- 
S runs, you can enter the name of the macro you want to use. 


Key Sequence What it Does 
1, [Ctrl]-[F10] Starts macro definition. 
2. [Alt]-S Names macro ALTS.WPM. 
3. Script subdir. Describes macro. 
prefix [Enter] 
4. [Alt]-[F10] Invokes macro playback. 
5. script\ Indicates subdirectory to use. 
6. (Ctrl]-[F10] Ends macro definition. 


When you press [Alt]-S, WordPerfect starts macro playback and 
adds the "script\" path name for you. Finish the process by typing 
CHAR and pressing [Enter]. 

The subdirectory prefix macro is a good example of what I call two- 
step macros, or independent (not chained or nested) macro sets. A 
two-step macro is one that uses two macros to execute a single func- 
tion. 

Another good example of a two-step macro can be found in the 
Headers and Footers section of Chapter 15. As described in that 
chapter, you create one macro that starts a header or footer, then a 
second macro that produces the actual header/footer definition. The 
benefit of the two-step macro is that each macro contains only the 
instructions needed to carry a process to a certain point. You can 
readily modify the prefix or suffix macro to accommodate any situa- 
tion. 

To edit an [Alt]-letter macro that resides on a different disk or 
directory than the current default, enter the drive/directory path 
and the full name of the macro such as: 
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A:MACROS\ALTM [Enter] 


Alternatively, use the Location of Auxiliary Files option in the 
Setup Menu. Provide the drive/directory for WordPerfect macros and 
keyboard layouts, such as: 


A:\MACROS 


Backup Copies 


Any number of disasters can happen to macros while they reside on 
your computer disks. Most hard disk users have experienced at least 
one "crash" during the life of their computer, when valuable data 
were lost due to a malfunction or a simple quirk. Also, floppy disks 
can be accidentally erased or damaged, and their contents lost 
forever. 

Perhaps most distressing is that a macro can be lost forever if you 
accidentally press 1 Replace instead of 2 Edit when you want to 
edit a macro. Even if you immediately press the Cancel key after 
realizing your mistake, the macro is forever erased. File reviving 
programs such as Norton Utilities don’t work because WordPerfect 
has destroyed the data previously in the macro, and re-recorded over 
it. Perhaps this more-than-minor problem will be corrected in a fu- 
ture version of WordPerfect. 

Always make at least one backup copy of your macros on a 
separate MACROS diskette. Store the MACROS diskette in a safe 
place, preferably away from your regular work area. Then, if some- 
thing should happen to the original macro, you can replace it with 
the copy. Be sure to periodically update the MACROS backup dis- 
kette so that it contains all the newly created and edited versions of 
your macros. 

Despite your best efforts in memorizing or carefully cataloging 
your macros, you are bound—sooner or later—to forget the name of 
a particular macro you want to use. Fortunately, you can have Word- 
Perfect help you locate stray macros by using the List Files com- 
mand. To work properly, your macros must have a description in the 
Description field (placed there when you created or edited the 
macro). 
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Key Sequence What it Does 
1. [Alt]-[F5] Chooses List Files menu 
[Enter] (or select a different drive or directory). 
2.9 Chooses Word Search option. 
3.1 Chooses Doc Summary option. 
4. (text) Defines the text string you 
[Enter] want to look for. 


WordPerfect searches the currently selected drive and directory 
and looks through the document summaries in all the files, includ- 
ing macros. The program marks the files that match the text string 
you have entered. 

For example, suppose you have written the description: "Keeps 
track of time while on phone" for a macro named TIMETRAK. WPM. 
In place of {text) in Step 4, above, you enter a key word or 
phrase, such as "track," "time," or "phone." WordPerfect finds 
TIMETRAK.WPM, along with any other macro or file that includes 
these key words in their document summaries. Feel free to use 
WordPerfect’s advanced search features, which allow you to set up 
elaborate search criteria, to help narrow the search. 


SHORTCUTS IN CREATING MACROS 


WordPerfect 5.0 lacks a great deal of sophistication when it comes 
to actually editing a macro. You are limited to WordPerfect’s stand- 
ard editing keys to insert and delete macro code. One feature miss- 
ing from the editor is a way to cut and paste macro code so you can 
move it within a macro or share code between macros. This forces 
you to write each macro from scratch, thereby consuming a great 
deal ofyour time and energies and increasing the chance of mistakes. 

However, if you are writing a macro that is based, at least in some 
degree, on another macro, you can use a simple technique to reduce 
unnecessary work. Before writing the new macro, make a copy of the 
old one using DOS or the copy command in the List Files menu. Edit 
the copy and alter the macro as required. 

Another time saver is to write commonly used macro segments or 
routines as alternate key definitions. You then need only to press 


the proper keys and the entire routine is automatically entered into 
the macro. 
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Let's say, for example, that you have defined [Ctrl]-N, (using the 
keyboard Layout option in the Setup menu) with the following com- 
mon macro code: 


(ASSIGN) 1~~ 
(LABEL}loop~ 
(VAR 1) 
(LOOK) 1~ 
(IF) (VAR 1}= 
(ELSE) 

(END IF) 


To enter the code into a macro, edit the macro as usual and posi- 
tion the cursor where you want the routine to be placed. Type [Ctrl]- 
V and follow with [Ctrl]-N (don’t forget the [Ctrl]-V or not all of the 
macro code will be entered). You may repeat this process a8 many 
times as you wish. 

Dedicate an entire keyboard layout file to commonly used macro 
Segments (some of the code segments described in the rest of this 
chapter are good candidates). Activate the layout whenever you are 
writing or editing macros. Keep a list handy that describes the 
definition of each of your assigned keys. 

If you want to use a macro as a routine in another, larger main 
macro, you can use the keyboard layout technique but you must first 
convert the sub-macro into a keyboard definition. Chapter 3 explains 
how to retrieve a previously written macro and assign it to a key. 
Once the macro is converted, you can retrieve it into the main macro 
at any point you desire. 


LABEL NAMES 


WordPerfect imposes no restrictions on the length or characters used 
to define labels within macros. Each label should be different from 
others used in the macro. Remember that the longer the label, the 
greater the chance of writing it incorrectly elsewhere in the macro. 
If you misspell a label, WordPerfect will ignore it and the macro will 
not function properly. I have tried to use single word labels 
throughout this book, with no punctuation marks or special charac- 
ters, to minimize the possibility of errors in spelling. 
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CHAINING, NESTING, AND SUBROUTINES 


WordPerfect can accommodate up to 10 levels of nested macros. That 
is, MACRO1 nests to MACRO 2, which nests to MACRO 3, and so 
forth, all the way to MACRO 10. If you try to add more than 10 levels 
of nesting, WordPerfect will complete only those macros that it can, 
and stop. No error message is provided. Each nested macro can chain 
to only one other macro. WordPerfect doesn’t allow you to chain from 
a nested macro, then chain to another before returning to the main 
nesting macro. 

Some additional tips, techniques, and caveats when using nesting 
and chaining. 


The (CHAIN) command should be at the end of the macro, not 
somewhere in the middle. If you do use the (CHAIN} command in 
the body of the macro, add a (RETURN) statement after it. 


¢Similar to nesting macros is manually invoking a second macro 
while running a first. You can safely do this IN MOST INSTAN- 
CES, but only if the second macro is the [Alt]-letter variety. 


elf you are having difficulty in getting the (CHAIN) command to 
work properly, use (NEST) instead. If you want all macro execu- 
tion to stop after the nested macro has returned, add a (QUIT) 
statement, such as (NEST})macrob~(QUIT) 


¢Nested subroutines are like nested macros, except that the sub- 
routines are run without leaving the main macro. WordPerfect 
can accommodate up to 20 nested CALL or CASE CALL instruc- 
tions per macro. If you try to add more, the macro will perform as 
many subroutines as it can and then stop. 


Note that a nested subroutine is not the same as a single sub- 
routine that executes and finishes. When encountering a single sub- 
routine in a macro, WordPerfect drops down to the CALL or CASE 
CALL level, executes the subroutine, then goes back to the main 
macro level. With nested subroutines, WordPerfect drops down each 
CALL or CASE CALL level to execute the subroutines in turn. At 
each (RETURN) instruction, WordPerfect goes back up one level 
until it is finally back to the main macro level. 
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RETURNING TO STANDARD DEFAULTS 


Some of your macros may change one of WordPerfect’s standard 
defaults, such as units of measure, time format, or location of 
auxiliary files. Such a change may cause problems later on, so get 
into the habit of resetting the defaults back to normal before the 
macro finishes. Of course, the definition of "normal" is up to you, so 
if you like the time format as 1 January 1989 instead of January 1, 
1989, be sure to reset the default accordingly. 


CLEARING THE DOCUMENT 


If your macro retrieves a document, be sure to first clear the screen 
or else the retrieved file will be appended to previously written text. 
The exception to this is when you specifically want to add text to an 
existing document. Be sure to answer Y to the WordPerfect prompt 
that asks if you want to append the text. To clear the screen, add 
(Exit}nn at the appropriate point in the macro. 

Macros that create temporary scratch pads and menus should in- 
clude a "clear" instruction at the end. This prevents the extraneous 
text from interfering with your other work. If the scratch pad or 
menu is in Doc 2, be sure to switch to it first before clearing it. 


ADDING WARNINGS TO POTENTIALLY 
DISASTROUS MACROS 


One of the most common macros WordPerfect users create is one that 
clears the current document and starts with a new, fresh display. 
The macro is simple: 


[F7] 
n 
n 


Because the macro includes the answers to the fail-safe prompts 
issued by WordPerfect (the first asks if you want to save the docu- 
ment and the second asks if you want to quit WordPerfect), there is 
no way to reverse the action of the macro once you have started it. 


424 WordPerfect 5.0 Macros and Templates 


To prevent any mishap, always use full names for potentially 
dangerous macros, and be sure the name isn’t similar to any other 
macro you use. Avoid naming the macro with an Alt-letter combina- 
tion unless you add a fail-safe mechanism of your own, such as: 


CLS.WPM 
(DISPLAY OFF} 
(BELL) (BELL) 
(CHAR)0~{“R)Sure you want to clear the current document? 

(y/n): -~ 
(IF)" (VAR 0)"="y"~ 
(ELSE) 
(IF)"(VAR 0}"="Y"~ 
(ELSE) (QUIT) 
{END IF)(END IF) 
(Exit}nn 


This example macro (named CLS.WPM for clear screen) quits if 
you press any key other than y or Y. 


SPECIAL SEARCH CHARACTERS AND 
INSTRUCTIONS 


Some macro applications require you to search for some of 
WordPerfect’s unique codes. Or, you may wish to instruct Word- 
Perfect to conduct a more thorough search of the document, includ- 
ing any footers, headers, footnotes, and endnotes. Add these 
instructions to search codes in your macros as needed: 


To Search for Soft Pages—[SP¢] 


Keys to Press Appearance in Macro Editor 
[F2] (Search) 

(Ctrl]-V 

[Ctrl]-V AV] 

[Ctrl]-V 

[Ctrl]-[End] (Del to EOL) 


[F2] {Search} 
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To Search for Soft Returns—[SRt] 


Keys to Press Appearance in Macro Editor 
[F2] (Search) 

[Ctrl]-V 

[Ctrl]-V (^V) 

[Ctrl]-V 

[(Ctrl]-M (^M) 

[F2] (Search) 


To Search for Invisible Soft Returns—[ISRt] 


Keys to Press Appearance in Macro Editor 
[F2] (Search) 

[Ctrl]-V 

(Ctrl]-H (Home) 

[Ctrl]-V 

[Ctrl]-J (Enter) 

[F2] (Search) 


To Search the Entire Document (Extended Search) 


Keys to Press Appearance in Macro Editor 
[Home] 
[F2] (Search) 


. . . Test of search string. 


To Search Backwards Through Document 


Keys to Press Appearance in Macro Editor 
[Shift]-[F2] {Left Search} 

... rest of search string 

or 

[F2] (Search) 

[Up] (Up) 


... rest of search string 
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With the exception of [Shift]-[F2] (Search Left), you may use the 
same techniques with the Replace command. Here are some other 
useful techniques: 


eTo return to the cursor position after a search or replace opera- 
tion, press [Ctrl]-[Home], [Ctrl]-[Home]. 


eTo search for complete words only, enter a space before an after 
the word. Example: -hello. 


eTo include wildcards in the search string, add a ^X character 
anywhere in the search string (except for the first character). To 
produce the ^X, press [Ctrl]-V [Ctrl]-X. 


eTo insert an On code for a text formatting code pair (such as 
([BOLD]), press the corresponding function key once when enter- 
ing the search string. 


eTo insert an Off code for a text formatting pair (such as [bold]), 
press the corresponding function key twice when entering the 
search string. 


MACRO ROUTINES 


Throughout this book, I have reused certain basic routines—some to 
the point of exhaustion! These routines include Yes/No or 
TRUE/FALSE questions within IF. . .ELSE statements, key 
redefinitions, and counting loops. The various routines form a 
framework that allow you to construct other macros more easily. 
Once you have a handful of basic routines in your tool box, you need 
only reach in and use them in the next macro you build. 

Following are a number of the more useful routines developed for 
this book. In most cases they can be used as is in your own macros, 
but some may need to be modified to avoid conflicting with labels, 
variables, and subroutines you have already written. If a routine 
calls for placing a value into variable 1, for instance, and you are al- 
ready using that variable in your macro, change the routine so that 
it uses another variable instead. 
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Testing For Keyboard Entry 


WordPerfect contains a (LOOK) instruction that lets you assign any 
single character you type to a variable. The problem with the (LOOK) 
statement is that it doesn’t pause for user input. When the macro 
comes across the (LOOK) statement, it checks briefly to see if a key 
has been pressed, and if so, it assigns the key to the indicated vari- 
able. But unless you press a key only moments before the macro en- 
counters the (LOOK) statement (not likely), nothing will happen. 

The solution is to place the (LOOK) statement in a keyboard loop. 
These loops are used countless times throughout this book and are 
among the most useful of all macro routines, 

Example: 

(ASSIGN) 1~~ 

{LABEL} loop~ 

(VAR 1) 

(LOOK) 1~ 

(IF)"(VAR 1}"="(Enter)"~do something 

(ELSE}(GO)loop~ 

(END IF) 

In this routine, the macro is waiting for you to press the [Enter] 
key. When you press the [Enter] key, the macro processes the "do 
something" instruction (exactly what that is isn’t important here). 

At the beginning of the routine is an (ASSIGN} statement, which 
enters a null (nothing) into variable 1. This keeps any value pre- 
viously placed in variable 1 from being printed the first time the 
macro goes through the loop. The "loop" label allows the routine to 
loop back onto itself, but without encountering the {ASSIGN} in- 
struction again. The {VAR 1) instruction passes any keys—except 
[Enter]—through to the document. Without the {VAR 1} instruction, 
the keyboard entry will not show up on the screen. 

The {LOOK)1- instruction checks the last key you pressed and 
places it into variable 1. The (IF) statement that follows compares 
the value of variable 1 against the "(Enter)" string. Ifit matches, the 
macro executes the "do something" instruction; if it doesn’t match, 
the macro loops back to the "loop" label. Notice that the "(Enter)" 
string and "{VAR 1}" are both in quotes. This is necessary when com- 
paring non-numeric strings. 

When you press the [Enter] key, the routine "captures" it and the 
hard return doesn’t get passed through to the document. If you want 
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the hard return, the loop is repeated. Add an (Enter) code after the 
(IF) instruction. Another way to tackle the problem is to add the 
(VAR 1) statement after the (ELSE) instruction. 

You can always look for more than one key in a keyboard loop. As 
an example, you might test for the [Enter], [Tab], and [Home] keys 
with the routine below. Remember to add an (ELSE) and an (END 
IF) for every (IF) statement. The (GO}loop~ instruction should be 
placed after the last (ELSE). 


{ASSIGN} 1~~ 

{LABEL} loop~ 

(VAR 1) 

{LOOK}1~ 

(IF)"(VAR 1)"="(Enter)"~do enter 
(ELSE) 

(IF)"(VAR 1)"="{Tab)"~do tab 
(ELSE) 

(IF)"(VAR 1)"="(Home}"~do home 
(ELSE) (GO}loop~ 

(END IF)(END IF)(END IF) 


Redefining Keys 


While WordPerfect has a key remapping feature that lets you change 
the definition of any key—even make a key behave like a macro— 
you may also wish to redefine a key temporarily during the execu- 
tion of a macro. Recall earlier that the key the macro is looking for 
in a standard keyboard loop routine is not normally passed through 
to the document. You can press any other key and it prints on the 
screen, but the one you want is captured and not executed (of course, 
this all depends on how you have written the loop). 

You can use this feature to redefine the key. Instead of printing a 
hard return when you press [Enter], for instance, the macro may 
produce a hard page, a tab, a space, or any other character you want. 


{ASSIGN} 1~~ 

(LABEL)loop~ 

(VAR 1} 

(LOOK) 1~ 

(IF}"(VAR 1)"="(Enter)"~(HPg){GO)elsewhere~ 
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(ELSE) (GO)loop~ 
{END IF) 


This example shows how the [Enter] key is redefined as [Ctrl]- 
[Enter] (hard page). Whenever you press [Enter], the macro prints 
a [HPg] code in the document, then goes to the labeled name “else- 
where." If you plan on reentering the loop after the [Enter] key is 
pressed, place the (VAR 1) code after the (ELSE) statement, That 
way, the keys you press are only passed on to the document when 
the (IF) statement is false (not the (Enter) key). 

The real benefit of redefining keys using IF. . .ELSE is that you 
can make the keys behave in any manner you choose, even within 
the same macro. At the beginning of the macro, the [Tab] key may 
act like an ordinary [Tab] key, but later on may act like the [In- 
dent] key. You can use this feature to simplify tough formatting jobs 
or to temporarily reassign some of WordPerfect’s functions to those 
that are more comfortable for you. 


Accepting Upper and Lower Case 


WordPerfect variables are case sensitive. If you construct an 
IF. . .ELSE structure that looks for "y", the macro will ignore Y, 
along with all other keys. To accept both upper and lower case ver- 
sions of a letter, include both in their own IF. . ELSE statements. 
In the following example, pressing either n or N has the same result. 
Be sure to use a separate (ELSE) and {END IF) statement for each 
(IF) instruction. 


(IF}"(VAR 1)"="n"~{GO)no~ 
(ELSE) 

{IF}"(VAR 1}"="N"~{GO)no~ 
{ELSE} 

{END IF)(END IF) 


Waiting for Any Key Press 
Sometimes you just want the user to respond to a prompt or message 


and not press any particular key. For example, you may display the 
message "Press any key to continue.” Rather than writing an 
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IF. . ELSE instruction for every key on the keyboard, use the (IF 
EXISTS) statement. The routine is similar to keyboard looping. 


(PROMPT}Press any key to continue.~ 
(ASSIGN) 1~~ 

(LABEL) loop~ 

(LOOK}1~ 

(IF EXISTS) 1~do something 
(ELSE}(GO)loop~ 

(END IF} 


Another, easier method that works with most macros is to use the 
(CHAR) statement. The idea is that the (CHAR) statement stops the 


macro long enough so that you can press a key. Once the key is 
pressed, it goes on. 


‘{CHAR)9~Press any key to continue: - -~ 
(Ignore the value placed in variable 9.) 


Separating Macro Routines 


Labels allow you to specify different routines within a macro. Often, 
the labeled routines are not executed in sequence. A macro first ex- 
ecutes routine 1, then 3, then 2. The jumps from routine to routine 
are accomplished with the use of (GO) instructions 

Notice, however, that if you are not careful, the macro will execute 
routines 1, 3, 2, then 3 again. Why? Because the macro is not stopped 
after routine 2. Get into the habit of adding (QUIT) statements at 
the end of each routine to keep the macro from proceeding to a step 
it isn’t supposed to execute. Depending on the application, you may 
also use (BREAK), (CHAIN), (NEST), (RETURN), and other state- 
ments to forcibly terminate or redirect macro execution. 


Placement of Routines and Subroutines 


The layout of your macro will depend on the application and your 
programming habits. Some programmers like to stuff all of the 
routines and subroutines away from the "main" or working portion 
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of the macro. That makes analyzing problems (called “debugging” in 
programming lingo) easier. 

If the routine is part of the normal execution of the macro, insert 
it so that WordPerfect performs it in sequence with the rest of the 
instructions. If the macro jumps to special routines (when an 
IF. . ELSE instruction is TRUE, for example), place these routines 
at the end. Do the same for subroutines, which are used by the 
{CALL} and (CASE CALL) instructions. 


Displaying a Prompt In the Status Line 


The (PROMPT) statement is used to provide explanatory text or in- 
structions for the user. The statement does not expect a response, 
and so does not cause the macro to stop temporarily. If you enter text 
into the keyboard following a (PROMPT) message, the text is passed 
through to the document and not entered into a variable. 

Unlike a message you include in a (CHAR) or (TEXT) instruction, 
a prompt message typically stays in the status line only until the 
next macro instruction that writes text on the screen or turns the 
display off. Keeping the prompt message on the screen long enough 
so that it can be read can be a tough problem, but there are several 
solutions. 


Waiting The easiest method is to delay the action of the next in- 
struction. You may do so with the (WAIT) statement. I regularly in- 
clude a 1.5 second delay after the (PROMPT) statement to give the 
user time to read the message (longer messages require longer 
delays). 

Example: 


(PROMPT)Press y or n only.~(WAIT} 15~ 


The 15~ argument after the (WAIT) statement pauses the macro 
for 1.5 seconds (15/10ths of a second). After the specified delay, the 
macro will continue with the next instruction after the (WAIT) state- 
ment. 


Keyboard Looping A keyboard loop keeps the macro busy scan- 
ning the keyboard. The (PROMPT) message remains on the screen 
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until you press a key. For more information on keyboard loops, see 
the section above on Testing For Keyboard Entry. 


Pause Placing a (PAUSE) instruction immediately after the 
(PROMPT) message keeps the message on the screen until you press 
[Enter]. 


(PROMPT}Not a legal response. Press Enter to continue. (PAUSE) 


If you want to make sure that the (PROMPT) message doesn’t 
remain in the status line after you press [Enter], add {DISPLAY 
OFF) {DISPLAY ON) after the (PAUSE). 

When used in a keyboard loop, the (PROMPT) message will 
remain on the screen only until WordPerfect rewrites the screen. Ex- 
actly when this happens depends entirely on what you (and Word- 
Perfect) are doing at the time. In most cases, the prompt is erased 
when the text scrolls, which may occur when you type from the 
keyboard, press the [Enter] key, or press one of the cursor keys. 

Normally, there is no great difficulty imposed when the prompt 
message is erased by a WordPerfect macro unless the message is 
long or spans more than one line. If you notice that the macro erases 
only a portion of the (PROMPT) message, or leaves lines of a multi- 
line message, you need to provide a means to clean up after Word- 
Perfect. The easiest way to correct the display is to add a (DISPLAY 
OFF) (DISPLAY ON) code pair after the (PROMPT) message. Use a 
keyboard loop that waits for you to press any key—this provides a 
"time delay" for the display codes. See "Waiting for Any Key Press," 
above, for details on constructing a wait-for-any-key keyboard loop. 


An example: 

{(PROMPT)Press Enter when done or [F7] to quit: - -~ 

(ASSIGN) 1~~ : 
(LABEL) loop~ 

{LOOK)1~ 

(IF EXISTS) 1~ 

(DISPLAY OFF) (DISPLAY ON} 

(ELSE) (GO}loop~ 

(END IF) 

--+ Rest of macro 
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User Entry Using the {PROMPT}, {TEXT}, and 
{CHAR) Instructions 


When using the (PROMPT) instruction for requesting a response 
from the user, pressed keys are passed directly to the document. This 
is true even if you have added a (PAUSE) after the (PROMPT) mes- 
sage. The (CHAR) and (TEXT) instructions, which specifically ask 
for user input, print the answer in the status line. Ifyou want to pass 
the answer to the document, you must print the contents of the vari- 
able used with the (CHAR) or (TEXT) instruction to the document. 


{(CHAR)0~Enter today’s date. ~ 
(VAR 0} 


If you want the answer to appear directly in the document at the 
current location of the cursor, use the (PROMPT) instruction. You 
can also force the cursor to any position in the document window, as 
discussed in the next section. 


Enhancing Message Strings 


Message strings are printed in the status line using the (TEXT), 
{CHAR}, and (PROMPT) instructions. You can improve the ap- 
pearance of (TEXT) and (CHAR) messages by adding one or two 
blank spaces after the text and before the tilde, such as (the "-" 
character denotes a space): 


(TEXT) 1~Enter the name and address. : ~ 


With the extra spaces added, the cursor will be positioned away 
from the text, and text you write won’t be jammed up against the 
message. 

Control characters can be embedded in (TEXT), (CHAR), and 
(PROMPT) strings to enhance the appearance of the message. 
Among the most useful are bold, underline, reverse video, and blink. 
Use these display attributes when you wish to grab the user's atten- 
tion. 
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Bold: 

Turn On [Ctrl]-] 

Turn Off [Ctrl]-\ 

Example: (TEXT) 1~{*])Type your name here. (^\} -~ 
Underline: 

Turn On [Ctrl]-T 

Turn Off [(Ctrl]-U 

Example: (TEXT) 1~(4T)Type your name here. (*U}- ~ 
Reverse Video: 

Turn On (Ctrl]-R 

Turn Off [Ctrl]-S 

Example: (TEXT) 1~(^R)Type your name here. {‘S}- -~ 
Blink: 

Turn On [Ctrl]-N [Ctrl]-P 

Turn Off [Ctrl]-Q 

Example: (TEXT) 1~(4N} (4P)Type your name here. {^Q} -~ 


Turns off all display attributes, including blink, or... 


Blink: 
Turn On [Ctrl]-N [Ctrl]-P 
Turn Off [Ctrl]-O [Ctr]]-P 
Example: (TEXT) 1~(4N)(4P)Type your name 


here.{*QO}) (4P}- -~ 


Turns off only blink display attribute. 


Ringing the Bell 


Another way to call attention to a message is to add a {BELL} ìn- 
struction. When the macro encounters the (BELL) statement, the 
computer emits a short warning tone. You can link (BELL) state- 
ments to produce a cadence of tones to warn against impending 
danger. Place the (BELL) instruction before or after a prompt; the 
(BELL) must be placed in front of a (CHAR) or {TEXT} message. 


(PROMPT)This is a warning.~{BELL) 
(BELL)(CHAR)1~Are you sure you want to erase the file?~ 
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(BELL}(TEXT)1~Are you really, really sure?~ 


Messages Longer Than One Line 


WordPerfect allows you to display (TEXT), (CHAR), and (PROMPT) 
messages of nearly any length, although you should try to confine 
the text string to one line or less. If the message must span more 
than one line, add (Enter) codes in the message string. The (TEXT) 
string— 


(TEXT)1~Press a key to continue:(Enter) 
1 New File; 2 Old File; 3 Spell Check: ~ 


appears as 


Press any key to continue: 
1 New File; 2 Old File; 3 Spell Check 


—at the bottom of the screen. 

WordPerfect normally erases any message, but a remnant from 
the top line may appear in the text of the document. Although the 
remnant is not a part of the document—it will disappear after a 
while—it can be distracting. To prevent remnants from drifting 
through your documents, clear the screen by adding (DISPLAY 
OFF) (DISPLAY ON) as the next instruction after the message. The 
screen will flash off very quickly, then turn back on again, this time 
without the message or any remnants. You can use this technique 
to safely build even large multiple-line menu displays. 


Recovering From Failed Searches and Errors 


When a Search in macro ends with a *not found* message, the macro 
is abruptly ended. If you don’t want the macro to finish premature- 
ly when a search fails, add an (ON NOT FOUND) instruction at the 
beginning and instruct WordPerfect to jump to a standard "I didn’t 
find that entry" routine. The routine can actually be in the same 
macro or the routine can be a nested macro. 
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On Not Found Subroutine 
(ON NOT FOUND}){CALL)notfound~~ 
... rest of macro 
(LABEL)notfound~ 


(PROMPT}Sorry, the search failed.~{(BELL) (WAIT)15~ 
(RETURN) 


On Not Found Nested Macro 
{ON NOT FOUND} (CALL) notfound~~ 
... rest of macro 
(LABEL)notfound~ 
(NEST) notfound~ 
(RETURN) 


The second example includes a subroutine before the {NEST) in- 
struction because the (ON NOT FOUND} instruction cannot be used 
to directly branch to a nested macro. Remember to use two tildes at 
the end of the (ON NOT FOUND) instruction when using (GO) and 
(CALL) statements. 

The same technique can be used to recover from an error. Most er- 
rors in macros occur because WordPerfect cannot find some file it 
needs, The following routine is especially helpful if you regularly 
keep your macros on another disk or in different directories. It lets 
you reenter the macro file name, drive, or directory after an error 
has occurred. The example assumes that you wish to chain to a 
macro called INVOICE.WPM. 


(ON ERROR) (CALL) error~~ 

{(CHAINJINVOICE. (Enter) 

---rest of macro 

{(LABEL)error~ 

(TEXT}1~Can’t find that file. Enter a new name, drive, or direc- 
tory.::~ 

{(CHAIN)(VAR 1){Enter]) 

{RETURN} 


When the macro can’t find the file, it calls the "error" subroutine 
as indicated after the (ON ERROR} instruction. The “error” sub- 
routine asks you to enter a new name, drive, or directory. Your 
response is recorded in variable 1, and is used in the (CHAIN} in- 


struction. Assuming that WordPerfect can find the proper file, the 
macro returns to where it left off 
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If you wish merely to have WordPerfect ignore cancel, error, and 
not found conditions, enter the (ON CANCEL)~, (ON ERROR)~ and 
(ON NOT FND)~ statements by themselves, This works for main 
level macros only, and may have unusual effects when used in a 
nested macro or subroutine. Remember that because you haven’t in- 
dicated a specific course of action, the macro won’t know what to do 
when it encounters a cancel, error, or not found condition. However, 
the macro will continue to run. 

Be sure that you provide an alternate means to terminate the 
macro if you use the (ON CANCEL)~ or (CANCEL OFF) statements.. 


Counters 


A counter is a routine that starts with a number in a variable, then 
either adds a digit to it or subtracts a digit from it. Counter routines 
are often used to keep track of the number of times the macro has 
completed an operation. 

A good example of using counters can be found in the quiz game 
presented in Chapter 15. Actually, three counters are used: one to 
monitor the current question number, and two others to keep score. 
The basic counter consists of an (ASSIGN) instruction that loads a 
starting number (usually 1 or 0) into a variable, and a loop that for- 
ces the macro to repeat some operation. Within the loop is an instruc- 


tion to add a digit to the assigned variable. 


{ASSIGN} 1~0~ 
(LABEL) loop~ 

-- -repeating routine 
(ASSIGN}1~(VAR 1}+1~ 
(GO) loop~ 


This example first assigns the value 0 to variable 1. The macro 
then enters the repeating routine segment. At the end of the seg- 
ment, the macro adds 1 to variable 1, then goes back to the start of 
the routine. You might use the value in variable 1 to test for some 
condition. Suppose you want to count the number of times you press 
the [Enter] key during a certain operation. After the second time, 
you want the macro to branch off and do something special. 
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(ASSIGN)2~0~ 

(ASSIGN) 1~~ 

(LABEL)})loop~ 

(VAR 1) 

(LOOK) 1~ 

(IF) (VAR 2})=2~(GO)print~ 

(ELSE) 

(EF}"(VAR 1)"="{Enter}~(ASSIGN)2~{(VAR 2)+1-~-(GO})loop~ 
(ELSE) (GO)loop~ 

(END IFMEND IF} 


The macro starts by loading 0 into variable 2. It then begins a 
keyboard loop routine that tests for the [Enter] key. An additional 
IF. . .ELSE instruction tests to see if the value in variable 2 is equal 
to a certain number (in this case 2). Each time you press [Enter], 
the macro adds 1 to variable 2. As long as variable 2 is less than 2, 
the macro will skip the first IF statement and go on. But the moment 
you press the [Enter] key a second time, the first IF statement is 
TRUE, and the macro branches off to the "print" routine. 


Moving Data Between Documents 


Doc 2 provides a handy scratch pad area for performing sundry tasks 
during macro execution. For example, Doc 2 might be used to set up 
a temporary math definition for calculating the numbers entered 
into Doc 1. A number of macro applications require you to transfer 
data from one document screen to another. 

The macro routines for doing this can be quite complex, depend- 
ing on the nature of the data and what you need to do with the in- 
formation. Yet the macro merely consists of the same steps you'd 
take if you copied text from one document manually and inserted it 
into another. You can use either the Move command to transfer data 
between documents or the Macro Commands "assign" feature. 

To transfer data from Doc 2 to Doc 1 using the Move command, 
first switch to Doc 2 (if you are not already there), then locate the 
data you want to move. Locating data can be tricky unless they are 
always in the same spot in the document, or unless you use a place 
marker that serves as a search string. An example of using a place 
marker is shown in Figure 16-1. Turn block on and select the data 
you want to transfer. Then choose [Ctrl]-[F4] (Move), and either: 
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°11 to move the data (deleting the original). 
°12 to copy the data. 


WordPerfect then lets you paste the copied or cut data by moving 
the cursor to the insertion point and pressing [Enter]. If your macro 
is structured so that the transferred data can’t be directly pasted 
into place, add a (Cancel) command immediately after cutting or 
copying. 

With the data stored in the WordPerfect buffer, switch back to Doc 
1, locate the spot you want the data to go, and press [Ctrl]-[F4], fol- 
lowed by 41. As long as you don’t cut or copy anything else, you can 
continue to paste the same data any number of places within the 
document. 

The Macro Commands "assign" feature works similarly to the 
Move command, except that you have up to 10 different buffers in 
which to place the data. You can only copy text using the “assign” 
feature; if you want to delete it from the original document, you must 
do so in a separate step using the editing keys. 


FIGURE 16-1 EXAMPLE OF PLACE MARKER 


GHnemosyne — Goddess of memory and mother by Zues and the nine 
muses. 

Laus — The king of Thebes. 

Krishna — The black one; one of the greatest of Hindu dieties, 
gryphon — An animal with the body of a lion, head and wings of 
an eagle, 

Harpies — Winged monsters, half-woman, half-bird. 


D:\UPSENTEXT\ PROVERB. TXT Doc Z Pg 1 Ln 1 Pos 18 
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The process for transferring text using Macro Commands begins 
the same as the Move command. Switch to Doc 2, and locate and 
block the data. Then, choose [Ctrl]-[Page Up], press 3 (for "As- 


sign"), and a variable number. For example, to paste data into vari- 
able 4, press: 


[Ctrl]-[Page Up] 34 


To retrieve the data, return to Doc 1 and press [Alt]-4 (or another 
variable number you used). The same data can be pasted indefinite- 
ly until you change the contents of the variable. 

Regardless of the transferring method you use, you must be sure 
that the macro knows exactly where to copy the data and exactly 
where to paste it. You may need to go through the steps of cutting 
and pasting the data manually and jot down the keys you press. 
Duplicate them in a macro and test it to be sure that it works the 
way you want. 

Note that WordPerfect variables can contain text only. With the 
exception of indent, hard page, hard return, and required hyphens, 
all formatting codes are encountered in the document are ignored 
when the text is pasted into the variable. 


Variable Repeating Keystrokes 


You already know that the [Esc] key can be used to repeat an al- 
phanumeric key or cursor key by the number of times you specify. 
You can use the {Esc} code in your macros to define the number of 
times that another key is repeated. You may also construct the 
macro in such a way that you can specify the exact number of repeats 
while the macro is executing. 

A good example is drawing a vertical line using the Line Draw fea- 
ture of WordPerfect. By asking for the length of the line, and stor- 


ing the length in a variable, you can control the number of times the 
[Down] key is pressed. 


Example: 


(TEXT}1~Enter the length of the line; press Enter when done: - -~ 
(Screen}21 

(Esc} (VAR 1} (Down) 

0 
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This technique is used to construct boxes and forms of all shapes 
and sizes, as discussed in Chapter 15. 


Using Macros with Name Searches 


Macros are primarily used to duplicate your keystrokes. Ifyou record 
a macro that selects a document from among the List Files directory, 
it may not be the same document that’s selected when the macro is 
run some other time. Instead of using the cursor keys to indicate a 
document to use, use the name search feature. Press n (for name 
search), type the name of the document you want, then hit [Enter]. 
Finally, select the option you want to use from the menu. 
The technique also works when selecting: 


°A key layout file from the Keyboard Layout menu. 
o An auxiliary user dictionary. 

eA printer or printer driver. 

° À predefined and named printer form. 

eA style. 

eA font in the Base Fonts list. 


Suppose you want to select a style named SPACER from the Style 
menu. Here are the actual keystrokes for the macro: 


Key Sequence What it Does 

1. [Alt]-[F8] Chooses Style menu. 

2.n Defines name search. 

3. SPACER Indicates style to use. 
[Enter] 

4,1 Turns style on. 


Simplifying Long IF. ..ELSE Structures 


Let’s say you've written a macro that scans for eight or ten different 
keys, and does something different for each key. Such a setup could 
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be used to construct a menu system that lets you choose an item from 
among several shown on the screen. The conventional way of doing 
menus with macros is to write a separate IF. . .ELSE instruction for 
each key or entry you want to check. An easier method is to use the 
{CASE) statement. 

The syntax for the (CASE) statement is simple, although poten- 
tially confusing: 

(CASE}value~casel~labell~case2~label2~-- 3casex~labelx~~ 


Elements of the {CASE} instruction: 


¢State a value (variable, number, or text). 
¢Provide possible value comparisons for each case. 


eIndicate labeled routines to jump to when the value matches a 
case. 


You can have as many cases and labels as you want, but make sure 
that you include a label for each case. Tildes separate the value, 
cases, and labels. An extra tilde is placed after the last label to in- 
dicate the end of the (CASE) instruction. Here’s a simple example: 


(CASE)}2~1~Label1~2~Label2~3~Label3~~ 


The line of instruction can be broken down into separate lines so 
you can see easily how the (CASE) statement is built. 


(CASE}2~ 
1~Labell~ 
2~Label2~ 
3~Label3~~ 


The macro compares the value (2 in the example) against each case 
in turn. Because case 2 is a match, the macro jumps to Label2. A 
case command used in a menu system that lets you choose one of 
eight options follows this basic construction. 


{DISPLAY OFF] 

A Quit WordPerfect 

B Start a new document 
C Save current document 
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D Retrieve document 

E Spell check this document 

F Print this document 

G Print another document 

H Run a program from within WordPerfect 
{DISPLAY ON) 


(ASSIGN) 1~~ 
{LABEL} loop~ 
(VAR 1) 
(LOOK) 1~ 


(CASE) (VAR 1)~ 

A~quit~ 

B~startnew~ 

C~save~ 

D~retrieve~ 

E~spell~ 

F~printthis~ 

G~printother~ 

H~runprogram~~ 
(GO) loop~ 
(LABEL) quit~ 

... Macro instructions for quitting. 
(LABEL) startnew~ 

... Macro instructions for starting new document, 
(LABEL})save~ 

... Macro instructions for saving document. 
(LABEL}retrieve~ 

... macro instructions for retrieving document. 
{(LABEL)spell~ - - -macro instructions for spell-checking. 
{LABEL) printthis~ 

... macro instructions for printing current document. 
{LABEL) printother~ 

... Macro instructions for printing another document. 
(LABEL)runprogram~ 

... Macro instructions for running a program from DOS shell. 


The (CASE CALL) instruction is used the same way as (CASE} 
statements except that WordPerfect treats the labeled routines as 
subroutines. After the subroutine finishes, WordPerfect jumps back 
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to the point immediately after the (CASE CALL} instruction to com- 
plete the macro. 


Constructing AND and OR Logic Using IF. . .ELSE 
Instructions 


Here’s a bit of technical mumbo jumbo that will either mean noth- 
ing or a lot to you. IF... .ELSE instructions are typically built to test 
for one of several conditions. When at least one of the conditions is 
TRUE, that portion of the macro is complete and WordPerfect 
proceeds to the next. Here’s an example: 


(IF) (VAR 1)=100~ 

(ELSE) 

(IF) (VAR 1)=200~ 

(ELSE) 

(IF) (VAR 1)=300~ 
{ELSE)(GO)false~ 

(END IF)(END IF) (END IF) 
(GO)true~ 


The structure of the macro routine is referred to as OR logic. If 
variable 1 is equal to 100 OR 200 OR 300, the macro jumps to the 
"true" routine. Any other condition causes the macro to jump to the 
“false” routine. Most of the macros in this book revolve around OR 
logic for IF. . .ELSE instructions. 

What if you want to build an IF. . .ELSE instruction that jumps 
to the "true" routine only if all of the conditions are met? This struc- 
ture is more commonly called AND logic, and it can be easily done 
in macros by moving the instructions around a bit. 

Following are two test macros that you can write yourself to ex- 
periment with the operation of AND and OR logic. 


¢The AND.WPM macro jumps to the "true" routine only if both vari- 
able 0 AND variable 1 are equal to 1. 


eThe OR.WMP macro jumps to the "true" routine if either variable 
0 OR variable 1 is equal to 1. 
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Chapter 4, “Macro Programming," touched on the topic of AND 
and OR logic. The AND and OR "truth tables," presented in that 
chapter, are repeated here for your convenience (see Figure 16-2). 
You can predict what either macro will do in a given situation by 
referring to the truth tables. 


AND.WPM (CHAPI8 directory on Applications Disk) 
(ASSIGN) 0~1~ 
(ASSIGN) 1~1~ 
(IF) (VAR 0)=1~ 
(ELSE) (GO})false~ 
(END IF) 
(F)(VAR 1)=1~ 
(ELSE) (GO)false~ 
(END IF) 
(GO)true~ 
(QUIT) 
(LABEL)true~It is true. (Enter) (QUIT) 
(LABEL)false~It is false.(Enter) (QUIT) 


OR.WPM (CHAP18 directory on Applications Disk) 
(ASSIGN) 0~1~ 
(ASSIGN) 1~1~ 
(IF) (VAR 0)=1~(GO)true~ 
(ELSE) 
(END IF) 
(IF) (VAR 1)=1~(GO)true~ 
(ELSE) (GO)false~ 
(END IF) 


FIGURE16-2 "AND" AND "OR" TRUTH TABLES 
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(QUIT) 
(LABEL)true~It is true. (Enter}(QUIT} 
{LABEL})false~It is false. (Enter) (QUIT) 


Testing the State of WordPerfect 


The {STATE) instruction allows you to test the current operating 
condition of WordPerfect. Depending on what the program is doing 
at the time, your macro may branch off in one direction or another. 
The current state of WordPerfect is reported as a decimal number. 
Although you don’t need to know exactly how WordPerfect uses 
the state numbers, it’s helpful if you want a full appreciation of what 
you can do with macros and the {STATE) instruction. State numbers 
actually represents a binary number (or "word") from 1 to 1024. The 
binary word is composed of 1s and Os, layed out in this format: 


1024 512 256 128 64 32 16 8 
0 0 0 0 0 0 00 


For every 1, you add the number above it. If there is a 1 below 4 
and 16, you add 4 and 16 together and you get 20. Here are the bi- 
nary (also called bitwise) equivalents of the numbers used in report- 
ing the current state of WordPerfect: 


Num Binary Equivalent State 


1 00000000001 Doc 1 active 

2 00000000010 Doc 2 active 

3 00000000011 Doc 3 (special) active 

4 00000000100 Main editing screen (typically on) 

8 00000001000 Editing structure other than main 
document 

16 00000010000 Macro definition active 

32 00000100000 Macro execution active (always on) 

64 00001000000 Merge active 

128 00010000000 Block active 

256 00100000000 Typeover active 

512 01000000000 Reveal codes active 

1024 10000000000 Yes/No question active 


Notice that with the exception of Doc 3, the position of the 1 in the 
binary string changes position right to left. Think of the binary 
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string as a bank of switches. When the number is 0, the switch is off 
and that feature of WordPerfect is not active. If the number is 1, the 


switch is on; the corresponding feature is on. 

If several conditions or modes are on at any one time, as they often 
are, they are added together. For example, reading the state during 
macro execution when WordPerfect is in Doc 1 and main editing 
screen, and when typeover is active, returns a value of 293. 


o1 for Doc 1. 

°4 for main editing screen. 
°32 for macro active. 

°256 for typeover active. 


The number for that state, with the appropriate ‘switches’ flipped 
up, would be 


1 00000000001 Doc 1 active 

4 00000000100 Main editing screen 
32 00000100000 Macro execution active 
256 00100000000 Typeover active 

= 00100100101 293 


Entering (STATE) by itself in the macro causes WordPerfect to 
print the state in the document. You probably want to test for a par- 
ticular operating mode by incorporating the (STATE) statement in 
an (IF}, (CASE), (CASE CALL), or (ASSIGN) instruction. You can 
separate the exact mode you want to test for by using the AND logi- 


cal operator. 
Example: 
(ASSIGN) 1~(STATE) &256~ 


This instruction tests whether or not typeover is currently active. 
If typeover is ON, the value in variable 1 is 256 (the equivalent of 
the Typeover on state value). If typeover is OFF, the value in vari- 


able 1 is 0. 
You can directly apply the ANDed (STATE) instruction in an 


IF. . .ELSE structure. Here’s one used several times in this book: 
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(Save) TEXT. TXT (Enter) 

(IF) (STATE) &1024~y(GO)finish~ 
(ELSE) (GO)finish~ 

(END IF) 


This routine begins to save a document using the name 
TEXT.TXT. The file may already exist, so the {IF} instruction tests 
for the Yes/No question ("do you want to replace the file?") with 
(STATE) &1024. If the Yes/No question is active, the result is 1024, 
which WordPerfect interprets as TRUE (to WordPerfect, any num- 
ber other than 0 is considered TRUE). The macro enters ay for "yes" 
and jumps to the "finish" routine. If the Yes/No question is not ac- 
tive (the file doesn’t already exist), the result is 0, which WordPerfect 
interprets as FALSE. The macro jumps directly to the "finish" 
routine. 

Another way of implementing the (STATE) instruction with an 
IF. . .ELSE is to use (ASSIGN). The following example checks to see 
if typeover is active. If it is, the macro jumps immediately to the 
"start" routine. If it isn’t, the macro first turns typeover on, then 
jumps to "start." 


(ASSIGN)0~(STATE) &256~ 
(IF) (VAR 0})=256~(GO}start~ 
(ELSE) (Typeover)} (GO}start~ 
{END IF) 


Using the “P Display Code 


Of all WordPerfect’s display codes, the ^P code—used to indicate an 
exact spot on the screen for a (PROMPT), (CHAR), or (TEXT) mes- 
Sage—is the most versatile. Yet it’s also the hardest to master. 
The “P code is followed with a two character argument that indi- 
cates the column and row for the start of the message string. How 
are these used? The screen display can be divided into 80 columns 
across by 25 lines deep (assuming a standard 80 by 25 monitor). Let’s 
say you want the message “Press Enter Now" to start at the inter- 
section of the 30th column and the 15th line. You'd enter: 
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(PROMPT) (“*P)character code for 80th column; character code for 
15th line Press Enter Now~ 

The character codes you use to indicate a spot on the screen can 
be potentially confusing, so read carefully. Instead of a letter or num- 
ber, you use one of the IBM Extended Character Set ASCII charac- 
ters. Character code 128, the first extended character of the set, is 
position 1 (column or line), Character code 129 is position 2, and so 
forth. To enter an extended character code, hold down the [Alt] key 
while typing the number on the numeric keypad (not the numbers 
along the top of the keypad). When you release the [Alt] key, the 
character appears on the screen. 

Here’s an example: The Ç character is ASCII 128. Create it by 
holding down the [Alt] key and typing 1 2 8. Release the [Alt] key 
and the Ç character appears. 

You need to identify both the column and line after the “P code, 
so you must enter two codes (the column code goes first, followed by 
the line code). To position the message at the upper left corner of the 
display (ASCII 128 for the column, and ASCII 128 for the line), enter 
{AP}CC Your message goes here. ~ 

To arrive at the proper ASCII number to use for other locations, 
add the desired column or line number to 128. For example, to place 
the message starting at column 30 and line 15, use ASCII 158 (128 
+ 30) and ASCII 143 (128 + 15). 

You can start the message anywhere along the width of the dis- 
play up to column 79 (ASCII 207). After that, WordPerfect automati- 
cally wraps the start of the message to the next line. Wrapping will 
also occur if the message extends beyond the 80th column. Addition- 
ally, you can start the message along the length of the display up to 
line 25. Realistically, however, you would not generally use the 25th 
line with the “P display code, because that’s the normal status line 
used for WordPerfect message prompts. 

Figure 16-3 shows a map of the display, divided into 80 columns 
by 24 rows. The figure shows a message at position 158, 138 (column 
158, line 138), and the codes used to place it there. 

Note that some IBM PC compatible computers do not fully sup- 
port the [Alt]-keypad method of entering extended characters. If 
your computer doesn’t work as outlined above, use WordPerfect’s 
compose key ([Ctrl]-2) to enter the special characters. 
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128 


133 159 143 148 153 158 363 168 173 185 188 193 


198 203 207 


158,138 (Re) 


FIGURE16-3 SCREEN MAP 


A Practical Application of the “P Code 


The versatility of the ^P display code may not be immediately ap- 
parent to you. Apart from giving you the ability to insert a message 
anywhere on the screen (a dubious capability at best), the “P code 
can be used to construct "pop-up" windows or menus. 

The window is composed of separate lines of the {PROMPT}, 
(TEXT), or (CHAR) message, and has the effect of temporarily over- 
writing any text that’s underneath. Once the window is removed, the 
original text re-appears. By formatting the lines of the message with 
a box frame, as shown in Figure 16-4, you can make a realistic-look- 
ing pop-up window. You have full control over the size and place- 
ment of your windows. 

Following is a sample macro that displays the window shown in 
the previous figure. The example (which, for space reasons, is not on 
the Applications Disk), is an adaptation of the HELV.WPM macro 
found in Chapter 15. Its function is to allow you to easily choose one 
of the several faces of the Helvetica font (used with the Apple 
Laserwriter and other PostScript- compatible printers). As you can 
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CHAPTER 1 


Select a font! 
Helvetica 
Helvetica Bold 
Helvetica Bold Oblique 
Helvetica Narrow 
Helvetica Narrow Bold 
Helvetica Narrow Bold Onblique {lud and 
Helvetica Narrow Obl {que 


An icy haze hun 


the light of the sca 


Lining the narrou av 


worn from age, muddi 


DNOWN DWN» 


upyardly mobile neig 


profitless enterprises — a used book store, an apothacary shop, an 


office for a unlicensed doctor. All uere closed for the night; 


doors bolted shut, fron bars locked in place over the windows, 


A lone Figure stood among the brick buildings, a figuro 


accustomed to the dankness af the night and the glare of the street 


FIGURE 16-4 WINDOW 


see in the macro listing, a second, smaller box is also used to prompt 
for the point size of the font. 


{ON CANCEL }{GOJcarncel** 


{CCHARIIY 

C“FFOU {Enter)> 
{(“F306(--Select:-a-forntiy---- 2st eter e tte {Enter} 
(“P}G6al-°1--HeElvetica--+--+-+-- ee erst sete eee {Enter} 
{(“P}G6al(-°-o--Helvetica-Rold:---++*-*:t+-ee: {Erter}? 
{(*P}6a(--S3--Helvetica-Bold-Oblique>:::----- {Enter} 
{°“PIOA(--4--Helvetica-Narraow:s+--cce ttt eee {Enter} 
{“P}6¢ -S--Helvetica-Narrow:-Bold---:-°*::-°: {Enter} 
{“P}66|--6--Helvetica-Narrow:Bold-Oblique:-- |<{Enter> 
{“F'}0eG|--7--Helvetica-Narrow:Oblique:::---- {Erten} 
{^P}öè | --B--Helvetica-Oblique-'--»s--sss-0%- {Enter} 
{“P}07 {Ernter) 
{Home} 


aw 


{DISPLAY OFF? 
{DISPLAY ON} 


{TEXT)Q@Q~ 
{1^P)ōöi {Ent en} 
{€“Pio6al--Enter-a-fant-sjre-------- {Enter 


{I“PJ6A (Enter) 
C*P35AY (3) Places curser beck in font size bor 
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{DISPLAY OFF} 


{CASEJLVAR 1}* 
1*Hel® 
2~Bold~ 
5*Bold-oblique~ 
4*Narrow™ 
S~Narrow:- bold” 
6*Narrow-beld-cblique™~ 
7~Narrovw-oblique~ 
8~Oblique™~ 
~ 


{LABEL )HelY 
{Font }4nHelveticatEnter} 
1<{VAR @){Enter } 
{QUIT} 


{LAGELIBald™~ 
{Font GnHelvetica-BRold{Entery 
1{VAR O}{Enter} 
(QUIT) 


{LABEL FHold-oblique~”y 
{Font  4nHelvetica-Bold-ObliquetEnter? - 
I{VAR O}{Enter) 
CQUIT> 


{LABEL FNarrow~Y 
(Font }4nHelvetica-Narrowf{Enter) 
1{<VAR @}<{Enter?} 
{QUIT} 


{LABEL }Narrow- bold” 
{Font }4nHelvetica-Narrow- Bald 
{Enter}iICIVAR O}C(Enter)} 
{QUIT) 


(LABEL dNarrow:- bold-oblique™~ 
{Font }4nHelvetica-Narroaw-Bold-Oblique 
CEnterdJICVAR Ad{Ernterd 
{({QUIT} 


{LABEL dNarrow-oblique™~ 
{Font }4nHelvetica-Narrovw-Oblique 
{Enterdi{VAR Q}C{Ernter} 
{QUIT} 


{LABELIObIique™” 
{Font }4nHelvetica-Oblique{Ernter) 
1<VAR O)}<Enter) 
{QUIT} 


{LABEL }cancel™~ 
{DISPLAY OFF? 
{DISPLAY ON? 
{QUIT} 


Text within the pop-up window is formatted using empty spaces. 
Each line of the window MUST end with an {Enter} code. Be sure 
that you use the proper screen locations after the (“P} code, or your 
window will be literally "shattered," with segments strewn all over 


the screen. 
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Sadly, you cannot use WordPerfect’s Line Draw feature to make 
box frames for your pop-up windows. You must create them in the 
macro editor yourself by using the [Alt]-keypad method outlined 
above, or with WordPerfect’s compose key. Figure 16-5 is a handy 
template that identifies the ASCII and compose key equivalents for 
producing four different types of box frames. 

When using the [Alt] key method, press the [Alt] key and a num- 
ber on the keypad for each segment of the frame. Use the [Back- 
space] and [Delete] keys to remove unwanted segments. . When 
using the compose key methods, press [Ctrl]-2, type the code for the 
segment you want to use (don’t forget the comma), and press 
[Enter]. Repeat the process for each segment of the frame. Use the 
[Backspace] and [Delete] keys to remove unwanted segments. 


IMPORTANT TOPICS 


°Use [Alt]-letter combinations for those macros you access most 
often. Whenever possible, choose a letter than mnemonically rep- 
resents the macro. 


o When naming macros, avoid cryptic names, as well as names that 
are too similar to others already in use. 


°Use DOS subdirectories to catagolrieze macros for easy access. 
Because the macros are in a subdirectory, you must enter the sub- 
directory name when calling the macro (exception: when you have 
indicated the drive and directory in the Location of Auxilliary 
Files option). 

eAlways make at least one backup copy of your macros on a 
separate MACROS diskette. Store the MACROS diskette in a safe 
place, preferably away from your regular work area. 


e WordPerfect imposes no restrictions on the length or characters 
used to define labels within macros, but each label should be dif- 
ferent from others used in the macro. 


eIf your macro retrieves a document (in order to display a menu, 
for example), be sure to first clear the document or the retrieved 
file will be appended to previously written text. The exception to 
this is when you specifically want to add text to an existing docu- 
ment. 
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FIGURE16-5 BOX MAKING TEMPLATE 


*The (LOOK) command is often used in a keyboard loop routine to 
wait for you to press a certain key. 

Keyboard looks using the (LOOK) command and IF...ELSE struc- 
tures can be used to termporarily redefine keys. 

*Macros are case sensistive. If you want to test for both upopoer 


and lower case of a letter (such as y and Y), enter duplicate (IF) 
statements for each letter. 
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olf the routine is part of the normal execution of the macro, insert 
it so that WordPerfect performs it in sequence with the rest of the 
instructions. 
o If the macro jumps to special routines (when an IF...ELSE in- 
struction is TRUE, for example), place these routines at the end. 
Do the same for subroutines, which are used by the (CALL) and 
(CASE CALL) instructions. 

oA message generated with the (PROMPT) instruction stays on the 
screen only until the next macro instruction that writes text on 
the screen or turns the display off. You can keep the message on 
the screen using a (WAIT) instrction, a keyboard loop, or a 
{PAUSE} instruction. 

oMessage strings are printed in the status line using the (TEXT), 
(CHAR), and (PROMPT) instructions may be enhanced by embed- 
ding them with special control characters. Some commonly used 
control characters: 


Bold: 
Turn On [Ctrl]-] 

Turn Off [Ctrl]-\ 
Underline: 

Turn On [Ctrl]-T 

Turn Off [Ctrl]-U 
Reverse Video: 

Turn On [Ctrl]-R 

Turn Off [Ctrl]-S 

Blink: 

Turn On [Ctrl]-N [Ctrl]-P 
Turn Off (Ctr]]-O [Ctrl]-P 


e Add (Enter) codes in the message string if it too long to fit on one 


page. 
eTo prevent remnants from drifting through your documents, clear 
the screen by adding (DISPLAY OFF](DISPLAY ON) as the next 
instruction after the message. 
e Use {ON ERROR) on recover from errors in WordPerfect, DOS, or 
the macro, and (ON NOT FOUND) to recover from failed searches 
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(include name searches using the List Files, Style, and Font 
menus). 


¢Counter routies are used to keep track of the number of times the 
macro has completed an operation. Counters can add one or more 
digits to the base count, or subtract one or more digits. 


¢Use name searches to find WordPerfect documents or support files 
during macro exeuction. Name search works with: 


¢A document from the List Files menu. 

A key layout file from the Keyboard Layout menu. 
e An auxiliary user dictionary. 

eA printer or printer driver. 

¢A pre-defined and named printer form. 

eA style. 

eA font in the Base Fonts list. 


*Use the (CASE) and (CASE CALL) statements to simplify com- 
plex IF...ELSE structures. 


CHAPTER 17 


MACRO DEBUGGING 


The best novels are not written, they say, but rewritten. The same 
is true of the best macros. Not only will you rewrite your macros to 
make them even better and more productive, but you'll rewrite some 
of your macros because you will be plagued from time to time with 
inexplicable problems. 

When things don’t work properly in computer programs, it’s called 
a bug. Understandably enough, ridding your macros of bugs is called 
debugging. This topic is important enough to any serious Word- 
Perfect macro user to devote an entire chapter to it. If you're ex- 
periencing problems with your macros, read through this chapter 
before pulling out your hair. 


ISOLATING THE PROBLEM 


Mistakes during macro keyboard entry or editing are common, 50 
you should always double-check your work at the first sign of a 
problem. Things to look for: 
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¢Spelling of filenames and labels. Be sure that file names (for docu- 
ments, styles, macros, and so forth), are spelled exactly. Don’t for- 
get the extension when specifying non-macro files (WordPerfect 
always assumes the .WPM extension when referring to macros). 
Be sure labels are spelled correctly and don’t have any extraneous 
characters or spaces. 


e Argument tildes. WordPerfect uses the tilde character as an ar- 
gument delimiter for its macro instructions. Leaving out a tilde 
on any statement that requires an argument will cause the macro 
to fail. Refer to Chapter 4, "Macro Programming,’ for a review of 
macro statements and their format. Possible problem areas for 
missing tildes are in the comment statement, (CASE) and (CASE 
CALL) statements (these require tildes between each argument 
and two tildes at the end), and double tildes when using (GO) or 
(CALL) statements with (ON CANCEL), (ON ERROR}, and {ON 
NOT FOUND). 


¢Proper macro code. Check to make sure that you are using the 
proper statements and codes. Review the macro carefully and 
watch for an accidental {Switch} or {Enter) code. If necessary, add 
commented returns (press [Enter] to move the code down a line) 
and commented tabs so that you can read the code more easily. 
An example is shown in Figure 17-1. 


*Proper macro sequence. It’s quite possible to enter a code or state- 
ment into a macro at the wrong place while editing it. Double- 
check. 


e Duplicated labels. Label names can be used only once in a macro. 
Review all labels to make sure that you haven’t duplicated them. 


¢Incorrect variable. Keep an eye out for the variables you use and 
how you use them. Test the contents of variables after the macro 
has been executed by pressing [Alt] and one of the number keys. 
The contents, if any, will print out on the screen. If the contents 
seem incorrect, review the macro for a misplaced variable. Check 
all (ASSIGN) statements to be sure that you are using the proper 
variables. 


Determining Where a Problem Lies 


Barring any typographical errors in the entry of the macro, the next 
step in determining the cause of a problem is to isolate the routines 
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Macro: Edit 


File MACROS\COMMENT. UPK 


1 — Description 


2 — Action 


{ON ERROR} {(GO}error~~ 


{Retr ieve}CONTRACT, HENCEnter} 
CLABEL}start~ 
{DISPLAY ON} 

{Home} {Home} CUp} 


CASSIGN} O77 
CGOFhighlight~ 
CLABEL}1 oop~ 
{LOOK}e~ 

CIF” CUAR G}"°="C{Doun}"’~ 

{Block?}{Home?}{Left}(Doun?{GO0}highlight” 


Selection: Z 


FIGURE 17-1 COMMENTED CODE 


of the macro. Ifthe macro is large (more than two or three windows), 
you will probably have an idea of the approximate location of the dif- 
ficulty. If the macro isn’t copying a piece of text correctly, for in- 
stance, you know to look in the routine that finds the text, blocks it, 
and copies it. 

Carefully review the problem area one more time and look for er- 
rors. Then insert a (QUIT) instruction after the first step. Exit the 
macro and run it. The macro will proceed up until it reaches the 
(QUIT) instruction, then stop. Has the problem shown up yet? If not, 
reedit the macro, delete the first (QUIT) instruction and add another 
after the next step. 

Repeat this process one step at a time until you find the problem. 
Once the problem has been pinpointed, you can carefully study the 
malfunctioning step and determine what has gone wrong. Try the 
step yourself (without the macro) to see if it works under manual 
control. Usually, you will find a missing step or an incorrect code. 

You can also pinpoint problems using the (SPEED) and (STEP ON) 
instructions. (SPEED} slows down execution of the macro so that you 
can watch it perform its various steps. Set the speed once at the 
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beginning of the macro or at least at the beginning of the routine you 
believe is causing the problem. 

Note that even with one speed used for the entire macro, some 
operations (like writing text) go slowly, while others go much more 
quickly. You may need to adjust the speed of playback throughout 
the macro in order to see some operations. 

You set the speed by entering a number from 1 on up. Each unit 
represents 1/100 of a second, and denotes the extra time the macro 
waits before executing each step or printing each character. There- 
fore, entering {SPEED)100~ is equivalent to waiting an extra second 
between steps. For most debugging purposes, a speed of 10 to 75 is 
acceptable. The (SPEED) instruction is ignored when you turn the 
display off using the (DISPLAY OFF) statement. 

The (STEP ON) command lets you step through macro execution 
one operation at a time. You control the progress by striking any key 
on the keyboard. While the (STEP ON) command is useful for diag- 
nosing weird, off-the-wall problems, it has limited use in normal 
debugging. Not only does the macro execute the steps encoded in the 
macro, it displays in the status line the function keys and statements 
you have entered. Rather than indicating the exact function keys or 
statements you have entered, the macro indicates their number. 


The numbers for macro statements and function keys appear in 
Tables 17-1 and 17-2. 


Common Error Messages 


Normally, WordPerfect abruptly terminates macro execution 
when it encounters an error. These messages May or may not appear 
on the screen, depending on whether the macro has previously 
turned the display on or off. 

WordPerfect reports a File Not Found error when it cannot find a 
file for retrieval. If this error occurs during macro playback, Word- 
Perfect will execute as much of the macro as it can, then stop. Word- 
Perfect also reports a File Not Found error when it cannot locate the 
printer driver file originally used to format the document. The docu- 
ment will still open (using the default printer driver), but the error 
will still occur, causing the macro to stop. 

The Access Denied error message occurs, among other instances, 
when you attempt to save a document into a directory that doesn’t 
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TABLE 17-1 MACRO COMMAND NUMBERS 
These macro command numbers are shown in the status line 


during macro execution. 


(:) (comment) 
1 Assign 
2 Bell 
3 Break 
4 Call 
5 Cancel Off 
6 Cancel On 
7 Case 
8 Case Call 
9 Chain 
10 Char 
12 Display Off 
13 Display On 
14 Else 
16 Endif 
20 Go 
21 If 
99 Label 
23 Look 
24 Nest 
27 On Cancel 
28 On Error 
29 On No Fnd 
30 Pause 
31 Prompt 
32 Quit 
33 Restart 
34 Return 
35 Return Cancel 
36 Return Error 
37 Return Not Fnd 
388 Cit Speed -- Step Off 
39 Step On 
40 Text 
41 State 
42 Wait 
44 Macro Commands ([Ctrl]-[Page Up]) 
46 Original Key 


47 If Exists 
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TABLE 17-2 KEY COMMANDS 

These key command numbers appear during STEP ON operation 
and indicate a function or cursor key. Note that some of the control 
keys must be first prefaced with [Ctrl]-V when entering them in the 
macro editor. 


Key 

Number Code Press these keys to make the code: 
1 ^A [(Ctrl]-A 

2 AB [Ctr]]-B 

3 AG [Ctrl]-C 

4 ^D [Ctr]]-D 

5 ^E [Ctrl]-E 

6 ^F [Ctrl]-F 

7 AG (Ctrl]-G 

8 Home [Home] or [Ctrl]-H 

9 Tab [Tab] or (Ctr]}-I 

10 Enter [Enter] or (Ctrl]-J 

11 Del to EOL (Ctrl]-[End] or [Ctrl]-K 
12 Del to EOP {Ctrl]-[Page Down] or [Ctrl]-L 
13 AM (Ctrl]-M 

14 AN (Ctrl]-N 

15 ^O [Ctrl]-O 

16 AP [Ctrl]-P 

17 AQ [Ctrl]-Q 

18 AR [Ctrl]-R 

19 AS [Ctrl]-S 

20 AT [Ctrl]-T 

21 ^U [Ctrl]-U 

22 AV [Ctrl]-V 

23 Up [Up] or (Ctrl]-W 

24 Right [Right] or (Ctrl)-X 

25 Left [Left] or (CtrlJ-Y 

26 Down [Down] or [(Ctr]]-Z 

27 i [ (Escape) [Esc] or [Ctr]]-{ 
28 AN [Ctrl]-\ 

29 A] [Ctrl]-] 

32 Cancel [F1] 

33 Search [F2] 

34 Help [F3] 


35 R Indent [F4] 


~~ OOGhHA iM 


Ja à e 
FE E ©) O) &9 ©) 


List Files iPS} 


Bold [F6]! 
Exit [FT] 


Underline [F8] 
Merge R [F9] 


Save [F10] 

Setup [Shift] {F I] 
Left Search  (Shift]-[F2] 
Switch (Shift]-[F3] 


L/R Indent [Shift]-[F4] 
Date/Outline (Shift]-[F5] 


Center (Shift]-(F'6] 
Print (Shift]-[F7] 
Format (Shift]-[F8] 


Merge Codes [Shift]-{F9] 


Retrieve Text [Shift}-{F10] 


Thesaurus (Alt}-[F'1) 


Replace (Alt]-{F 2) 
Reveal Codes [Alt}-{F3} 
Block (Alt]-{F4] 


Mark Text [Alt)-[F3} 
Flush Right [Alt}-{F6] 
Footnote fAlt)-{F7} 


Style [AIt]-[F3} 

Graphics [AIt]-{F9} 

Macro tAItI-[F10] 
Shell (Corl[-(F tf 
Spell [Ciril] 
Screen (Cerll-[F3} 
Move (CrrU- E- 


TextIn/Out  [CurU-[F3! 
Tab Align (Ctrlj-{Fe! 
Math/Columns (Ctrt-{F7] 
Font (Ciri-LFs] 
Merge‘Sort = (Crrii-(Fy! 


Macro Define (CirU-LF 10} 
Backspace [Bacaspace] 


Del Delete? 


Word Right  [Crrii-Right] 
Word Left iCtrii+~ Left] 


Afama Pabuyghur B3 


End (End! & Goto [Ctr]]-[Home] 
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89 Page Up [Page Up] 

90 Page Down [Page Down] 
93 Typeover [Insert] 

94 Left Mar Re  [Shift]-[Tab] 
95 Hard Page [Ctrl]-[Enter] 
96 Soft Hyphen [Ctrl] 


Additional STEP ON codes: 
ALTA-ALTZ for nested/chained macros (ALTA) through (ALTZ) 
VAR0-VAR9 for variables (VAR 0} through (VAR 9) 


exist, or a directory that WordPerfect can’t find. Did you enter the 
proper path?) 

You can limit WordPerfect’s sensitivity to errors by including an 
(ON ERROR) statement in the macro. By itself, (ON ERROR) will 
trap errors, but won’t tell WordPerfect what to do when an error oc- 
curs. You can indicate a specific course of action by including an ac- 
tion statement following (ON ERROR), such as (ON 
ERROR)(RESTART)~. Not all macro statements can be used with 
(ON ERROR) and special syntax is required when using the (GO) 
and (CALL) instructions. See Chapter 4, "Macro Programming," for 
more details on using the (ON ERROR) statement. 


DIAGNOSING SPECIFIC PROBLEMS 


The cause of some problems is more obvious than others. Following 
are possible causes for a variety of obstacles you may encounter as 
you create your own macros. 


Beeping Computer 


If your computer beeps when it’s not supposed to during macro ex- 
ecution, the problem may be caused by the block command. Word- 
Perfect does not let you enter text while the block is on; the computer 
beeps as you attempt to enter text. If you’ve written a macro that 
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turns the block on, you must either complete an action that shuts 
the block off automatically, or you must turn it off manually by is- 
suing another (Block) code. You can readily see if the block is still 
on by stopping the macro just after the block code. 

You can also test for an active block condition by using the 
(STATE) instruction. Force the macro to turn off the block by adding 
this routine: 


(IF) (STATE) &128~(Block)}(GO)rest of macro~ 
(ELSE)(GO)rest of macro~ 
(END IF} 


Also note that you cannot switch from document screen to docu- 
ment screen when the block is on. If you do, WordPerfect will assume 
you want to change the capitalization of the blocked text. 


Quotation Marks and Variable Statements 


Quotation marks must be used around (VAR #} statements in 
IF. . .ELSE instructions when testing for non-numeric strings. The 
same rule applies to text strings placed in the (IF) instruction. You 
must also bracket function and editing key codes with quotation 
marks. Be sure that you use the quotes in pairs, or the macro won’t 
work. Use a separate set of quotes if testing for a text string that al- 
ready contains quotes. 


(IF) (VAR 1)=(Enter}~ Won’t work 
(IF}" (VAR 1)=(Enter)~ Won't work 
(IF)"(VAR 1)"="({Enter)~ Won't work 
(IF)"(VAR 1)"="(Enter)"~ Will work 
(IF)"VAR 1)"=""HELLO""'~ Will work 


If you forget to add quotation marks to both sides of the variable 
and text string, WordPerfect will still try to compare the values on 
both sides of the equals operator, but the result will always be 
FALSE, because a match will never be found. 
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Missing {ELSE} and {END IF} 


Each (IF) statement must be accompanied by a matching (ELSE) and 
(END IF) statement. The (ELSE) statement indicates what should 
happen if the IF instruction proves FALSE, and the (END IF) in- 
struction marks the end of the IF. ..ELSE structure. Unless you add 
the (END IF), the macro will assume everything after the (ELSE) 
statement is to be executed when the IF condition proves FALSE. 
The instructions to execute, when the IF condition is TRUE, can 
be placed immediately after the tilde following the (IF) statement, 
or they can be placed after the (END IF) statement. You can even 
place some of the instructions after the {IF} statement, as well as 
some after the {END IF) statement. The macro executes the instruc- 
tions immediately following the (IF) statement first, then goes on to 
those that appear after the (END IF) statement. For example: 


(IF) (VAR 0})=100~Instructions for TRUE 
(ELSE)Instructions for FALSE 
(END IF) 


Rest of macro—executed after finishing the instruction for TRUE 


Run-On Routines 


Special routines and subroutines are normally placed at the end of 
the macro. That way, they don’t get in the way of normal macro ex- 
ecution. If you do not tell the macro to stop, it will execute all the in- 
structions sequentially, and may inadvertently repeat some of the 
routines. Make it a point to include a (QUIT) instruction immediate- 
ly before any special routines or subroutines. That prevents the 
macro from accidentally running them. 


Blank Screen 


Should a macro seem to come to a lurching stop and display nothing 
but a blank screen (the *waiting* indicator may remain in the status 
line as well), it’s a good bet that the macro has stopped at a menu 
with the display off. Unlike the regular document window, Word- 
Perfect doesn’t automatically turn the display back on when you 
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finish up at a menu. Rewrite the macro so that you include a (DIS- 
PLAY ON) at the end or whenever the macro stops at a menu. 


Halted Execution 


If your macro suddenly stops working, but the display is still on, it 
could be an indication that it is caught in an endless loop. An end- 
less loop is when the macro repeats the same operation over and over 
again, with no means to stop other than by your pressing the Can- 
cel key. It is most often caused by a macro looping back on itself at 
the wrong point. Look for an errant (GO) instruction or a misplaced 


label. 


Missing {RETURN} 


The (RETURN) instruction at the end of a subroutine tells Word- 
Perfect to go back to the (CALL) or (CASE CALL) statement. If the 
(RETURN) is missing, the (CALL) or (CASE CALL) statement may 
not work at all or the macro may end prematurely. 

The (RETURN) instruction is also used as a signal in a nested 
macro to go back to the main macro. If a {RETURN} is not present, 
the nested macro will continue execution until it finishes. Ifyou don’t 
want the entire nested macro to run, be sure to include the 
(RETURN) statement at the appropriate spot. 


Search Not Found 


Even if the text you want to find is in the document, certain cir- 
cumstances may cause a search instruction to end with a *not found* 
message. Unless you trap the *not found* condition with an (ON 
NOT FOUND) instruction, the macro will stop prematurely, making 
it even more difficult for you to locate the problem. Keep these 
pointers in mind when searching through a document with macros. 


e Unless you are searching a document sequentially, be sure to start 
the cursor at the top of the text before starting. Just add a 
{Home})(Home}(Up) instruction prior to the search (use three 
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(Home) instructions if you want to move the cursor before any for- 
matting codes). 


*If you know that the text you want to look for is behind the cur- 
rent position of the cursor, use the (Left Search} command ({[Shift]- 
[F2]) to search backward. 


e Be sure to enter the search string exactly as it appears in the docu- 
ment. This is especially true of symbols you use for place markers. 
(Several of the advanced macros in Chapter 15 used place markers 
to identify the start and stop of text areas). 


¢Carefully note the sequence of events in the search instruction. If 
necessary, temporarily place (QUIT) statements at each step so 
you can visually check the progress of the search. 
In the macro, all searches must contain the initial search instruc- 
tion, the search string, then another search instruction, such as: 


(Search}@(Search) Searches for the @ symbol 
(Search}Total (Search) Searches for the text "Total" 
(Left Search}macro(Search} Searches backward through the 


text for "macro" 


The same general rules apply when using the Replace command. 


Wrong Variable Numbers 


WordPerfect variables may act strangely at times, but if you under- 
stand their operation, their behavior is logical. The ten variables, 
numbered 0 through 9, can accept any alphanumeric entry. When 
you enter a whole number into the variable, you can then perform 
some basic arithmetic with it. For example, if variable 1 contains the 
number 10, and variable 2 contains the number 15, you can add them 
together in a macro, such as: 


{ASSIGN)3~(VAR 1)+(VAR 2)}~ 


The total of (VAR 1) and {VAR 2) (25) is entered into variable 3. 
Pressing [Alt]-3 after running the macro prints the number 25. 

However, if you enter a fractional number into a variable, Word- 
Perfect no longer treats it as a number, but as text. If you enter 13.5 
into variable 1 and 17.8 into variable 2, the result is not 31.3 but 
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13.5+17.8. WordPerfect converts the decimal numbers into text, and 
since it cannot add two pieces of text together, it also displays the 
plus sign as part of the string. 

Variables have certain limitations. First, they cannot accept more 
than about 120 characters each. Second, they can only contain whole 
numbers between 0 and 65,535. Numbers larger than 65,535 are 
handled as text and may not yield accurate results when used in cal- 
culations. 

An unusual aspect of WordPerfect variables is that they are cir- 
cular. Adding 65,535 + 1 yields 0. Adding 65,535 + 2 yields 2, and so 
forth. By the same token, subtracting 1 from 0 yields 65,535, as 
shown in Figure 17-2. Remembering this can save you headaches 
when trying to figure out what’s wrong with your macro—because 
nothing may be wrong with it! 

If you are subtracting whole numbers and you end up with a nega- 
tive result, you can figure out the value of the negative number by 
adding another step in the macro. Suppose variable 1 contains what 
should be negative 15. When you print the value, WordPerfect dis- 
plays it as 65,521. To turn it back into a number you can deal with, 


add this instruction: 


ASSIGN1~(VAR1)~ 


Remember that the number 165 stored in variable 3 should be 
treated as a negative value. If you are keeping score, add the minus 
sign in a text string of the macro so that there is no confusion over 


the value of the number. 


FIGURE17-2 CIRCULAR NATURE OF VARIABLES 


Variable numbers 


vam] am] os] 0 | 1 [2 [3% 


Start 
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Macro Not Found 


Nested and chained macros can show up missing if they have been 
sequestered onto another diskette or tucked within some faraway 
subdirectory. You have two choices to remedy the situation: move 
the macro so that it’s on the current drive and directory, or rewrite 
the macro so that it can find the file it needs to complete its task. 

Nested and chained macros cannot be executed if you misspell 
their names. Double-check the spelling of the macro name. Word- 
Perfect assumes the .WPM file extension in {NEST}, {CHAIN}, and 
{Macro} instructions, so you don’t need to add it yourself. 

Following are the several ways to chain and nest macros: 


eNested Alt-letter macro. During macro definition (keyboard or 
editing), press [Alt] and a letter key. This nests the Alt-letter 
macro inside the main macro. 


¢Chained Alt-letter macro. Press [Alt]-[F10] during macro defini- 
tion (keyboard or editing), then press [Alt] and a letter key. This 
chains to the Alt-letter macro from inside the main macro. 


eNested named macro. Use the (NEST) statement in the main 
macro. The proper syntax for the statement is {NEST}macro-~. 
Don’t include an (Enter) code after the (NEST) statement. 


eChained named macro. Use the (CHAIN) statement in the main 
macro. The proper syntax for the statement is (CHAIN}macro~. 
Don’t include an (Enter) code after the statement. 


eChained named macro. Use the {Macro} statement in the main 
macro. The proper syntax for the statement is 
{Macro}macro{Enter}. You must include an (Enter) code after 
defining the macro name. 


Garbled Screen 


If the screen is garbled during macro execution, or even after the 
macro finishes, you need to do a little housekeeping to get everything 
back into order. The usual cause is a (TEXT), (CHAR), or (PROMPT) 
message drifting off with the rest of the document (the message is 
not a permanent intruder, but it looks terrible and may cause un- 
wary users unneeded heartache). 
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To keep the screen clear, temporarily turn the display off, then 
turn it back on again using (DISPLAY OFF](DISPLAY ON). The 
screen will flash very quickly. You can also try the Screen Rewrite 
command. Press [(Ctrl]-[F3], then press 0. 

Macros that change the margins or push the cursor beyond the 
normal boundaries may slide some text off the screen. This is 
natural, but it can be disconcerting if you're not expecting it. There 
isn’t much you can do, because it is a normal operation of Word- 
Perfect and has nothing to do with macros. You can alleviate the 
problem of cropped text by using an EGA or Hercules mono-graphics 
board that displays more than 80 characters across the screen. Be 
sure to use the proper display drivers with these boards or Word- 
Perfect will continue to display the standard 80 character screen. 


Some Keys Don’t Always Work Right 


WordPerfect’s key remapping feature is a great boon to power 
users, but can cause problems to the uninitiated. Because you can 
change the definition of any key, you run the risk of altering the 
definition of some keys critical to the operation of macros. For ex- 
ample, let’s say you’ve switched the definition of Reveal Codes and 
Help. [F3] becomes [AIt]-[F'3] and vice versa. You faithfully accom- 
modate the change in the macros you write. 

Now suppose you share your macros with someone else who has 
WordPerfect, but this person hasn’t changed the definition of the 
Reveal Codes and Help keys. The result? The macro doesn’t work or 
it behaves erratically. The moral: if you plan on sharing macros, 
avoid using redefined keys whenever possible, If it can’t be avoided, 
include the key layout file with your macros and have the layout file 
load automatically when the macro is executed, 

Of course, you are not immune from the effects of your own key 
reassignments. If you’ve reassigned some of the control keys to 
operate as WordStar cursor keys—as described in Chapter 3, “Macro 
Editing’—then you won’t be able to access the control key charac- 
ters when editing macros in some other applications. WordPerfect 
uses [CtrI]-E to move the cursor up, so you redefine it as (Up). Ifyou 
try to use [Ctrl]-E to insert a ^E merge code, for instance, the ^E 
character doesn’t appear; it moves the cursor up a line. In short, if 
you want to use reassigned keys for their intended purpose, turn any 
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key reassignments off (select "Original" in the Keyboard Layout 
menu). 


Pressing the Tilde Key During Macro Execution 


WordPerfect macros are fairly immune to outside distractions, but 
one key can cause serious trouble. Pressing the ~ (tilde) key during 
the execution of most macros will cause the macro either to stop, or 
to spew out gibberish. If your macro suddenly stops working after 
you've typed in some text, look to see if the tilde key was inadver- 
tently touched. If your fingers just seem to stray onto that key, you 
can redefine it using the Key Layout feature. Hither reset the 
keyboard before programming macros (you'll need access to the tilde 
character), or assign the tilde character to a key you are not likely 
to touch accidentally. 


Macros and Merges 


WordPerfect 4.2 had an annoying habit of stopping macro execution 
when you started a merge. Happily, that limitation is fixed in Word- 
Perfect 5.0. But be forewarned that although you can execute a 
macro and a merge simultaneously, you cannot define a macro and 
perform a merge at the same time. Starting a merge operation while 
defining a new macro from the keyboard immediately stops macro 
execution. If you want to include the instructions for a merge, you 
must do so within the macro editor. 


Missing WP.MRS File 


WordPerfect using the WP.MRS file to help decode macros for edit- 
ing. If the WP.MRS file is missing, WordPerfect will report a File 
Not Found error, and won’t let you edit macros. Be sure WP.MRS is 
on the current drive and directory and try again. A similar file, 
KEYS.MRS, serves as a resource file for keyboard layout editor. 
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Sluggish Performance 


Because WordPerfect has so many features, some of its operations 
are slower than they should be. This is especially true of search and 
sort operations, and is apparent in a number of macros, such as CON- 
TRACT.WPM (Chapter 9). For best performance, WordPerfect 
should be used on a "turbocharged" IBM PC or XT (with a 
microprocessor clock speed of at least 8 MHz), an AT, or anIBM PS/2. 


IMPORTANT TOPICS 


Isolating the program is the first step in debugging a macro. 
Things to look for: 


°Correct spelling of file names and labels. 

e Proper number and placement argument tildes. 
Correct macro code and sequence. 

e No duplicated labels. 

eNo incorrect variables. 


e Use the (STEP ON), (SPEED), and (QUIT) commands as tools to 
help find the location of a problem within a macro. 


eA beeping computer is indicative of the Block function on at the 
wrong times. 


A macro will work improperly, or not work at all when: 


eQuotation marks and variable statements are omitted or 
misplaced. 

e (ELSE) and (END IF) statements are omitted for each (IF) state- 
ment. 

eThe macro processes a routine when it isn’t supposed to, or is not 
told to stop at a specific point. 


eThe end of a subroutine lacks the necessary (RETURN) state- 
ment. 
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eA search fails, and (ON NOT FOUND) error trapping is not 
provided. 


eYou are using the wrong variable numbers. 


eYou have remapped the keyboard using the Keyboard Layout fea- 


ture (turn off all keyboard layouts to be sure all the keys work the 
way they are supposed to). 


The tilde (~) key was accidentally pressed during macro playback. 


CHAPTER 18 


USING BATCH FILES 
WITH WORDPERFECT 


Most people hate it, yet they are subjected to it daily. No, it’s not 
TV reruns of "Mr. Ed," it’s DOS, that loveable, irrepressible operat- 
ing system used by over 15 million people around the world. Even if 
you spend all day working with WordPerfect, you're bound to spend 
at least some time with DOS copying files, formatting disks, erasing 
unwanted files, and more. Fortunately, you can make these forays, 
into your computer's operating system, easier and more constructive 
with batch files. 

Batch files are macro-like "programs" you create yourself to 
operate your computer automatically—or at least semi-automatical- 
ly. This chapter provides helpful tips and techniques for working 
with batch files, especially as they relate to WordPerfect. You'll learn 
how to start WordPerfect more quickly after you turn on your com- 
puter, how to set up DOS menus that let you select the application 
you want to use, how to automate the WordPerfect Convert program, 
and much more. The pages that follow don’t exhaust the subject of 
batch files; if you want to learn more about them, check any good 
book on DOS or on batch file programming. 
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INSIDE A BATCH FILE 


The primary purpose of a batch file is to take the place of manual 
keyboard entry when starting a program or otherwise working 
within DOS. The entries in the batch file correspond to those keys 
you press when you invoke a particular DOS command or start a 
program. 

For instance, a batch file for changing from the root directory to 
the WordPerfect directory (named WP50), then starting Word- 
Perfect, would simply be: 


CD wp50 
Wp 


These are the same keys you’d press to change directories and 
start WordPerfect manually. As in DOS, each command or program 
name in the batch file is separated by a carriage return. All batch 
files must end with a .BAT extension, such as MENU.BAT or 
CONV.BAT. Without the extension, DOS won’t know it’s a batch file. 

You can create batch files in several ways. If the file is short, with 
only afew command lines, you can create it directly from DOS using 
the COPY command. Here’s how: 


Key Sequence What it Does 

1. COPY CON: (batch file) Starts the copy command and 
tells DOS to copy what you type 
from the keyboard (console) into 
the batch file. 

2. (command lines) Specifies the contents of the 
batch file. 

3. [F6] Adds a Ctrl-Z marker to indicate 
the end of the file. 

4. [Enter] Finishes the batch file; DOS 
indicates that it has copied 
the file. 


Review the contents of the batch file with the TYPE DOS com- 
mand. Enter TYPE {file name}, then [Enter]. DOS will display the 
contents of the batch file on the screen. 
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The COPY CON: approach doesn’t let you edit your batch files. 
You may use WordPerfect if you are creating long files or want to 
edit a batch file you've already created. Start WordPerfect and— 
using the default settings and no formatting codes—write the text 
of the batch file. Don’t press [F6] at the end. When you want to save 
the file, use Text In/Out (press [Ctrl]-[F5]) instead of the standard 
Save command. 


Key Sequence What it Does 
1. [Ctrl]-[F5] Chooses Text In/Out menu. 
2, 1 Selects DOS file. 
3.1 Selects Save option. 
4, (file name} Names the batch file. 
[Enter] Don’t forget the .BAT extension. 


WordPerfect saves the file in standard ASCII format. Leave Word- 
Perfect or test the batch file by exiting the program temporarily 
through the Shell command. 

Use Text In/Out when you want to edit a batch file, as well. 


Key Sequence What it Does 
1. [Ctrl]-[F5] Chooses Text In/Out menu. 
2.1 Selects DOS file. 
3.2 Selects Retrieve (LF/CR to [HRt]) option. 
4. (file name} Selects a batch file to edit. 
[Enter] 


Be sure to resave the file using Text In/Out again. If you acciden- 
tally save the document with the [F10] key, DOS won't be able to 
read it and your batch file won’t run. 

As an alternative to WordPerfect, you may create and edit batch 
files using the EDLIN line editor that comes with DOS. Refer to your 
DOS manual or a book on MS/PC-DOS to learn how to use EDLIN. 

Most batch files execute quickly, and are finished before you can 
realize it. Some batches take longer, however, or may present a 
prompt that asks for your input. If, for some reason, you want to can- 
cel the execution of a batch, press [Ctrl]-C. DOS replies with a "Ter- 
minate batch job? (Y/N)?" Press Y to exit the batch. 

Batch files work only until a program is loaded. Commands or text 
that you have typed after a program has started are ignored until 
you quit the program, Then, the batch file picks up where it left off 
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and executes the rest of the instructions. In this way, you can run 
several programs one right after the other. 

Like any programming language, batch files have their own in- 
structions or keywords. Some of the more powerful and useful 
keywords are presented here. Of course, there are many other batch 
file instructions, but these are the ones you will most likely use. 
Refer to a book on DOS for more information on the various batch 
instruction. 


ECHO turns the display on or off, or displays the message text 
immediately following the ECHO instruction. 


°CLS clears the screen. 


eIF tests for a condition and either continues executing the batch 
file, if the condition is false,or performs some specific action, if the 
condition is true. 


¢GOTO jumps to a labeled routine in the batch file. 
¢PAUSE stops to display a message. 

e PROMPT changes the appearance of the DOS A> prompt. 
*REM displays a message on the screen (ECHO must be on). 


BATCH FILES FOR STARTING WORDPERFECT 


In addition to starting WordPerfect with the standard WP name at 
the DOS prompt, you can also begin your sessions with the program 
by using one of 12 starting options. These options let you assign 
operating parameters to WordPerfect. Among the options available 
to you are: 


¢Set timed backup every xxx minutes. 
eStart WordPerfect and invoke a macro. 
eStart WordPerfect and open a document. 


¢Turn off some of WordPerfect’s features, such as cursor speed and 
enhanced keyboard calls. 


*Set the text display size of your monitor. 
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WordPerfect’s startup options are detailed fully in the Word- 
Perfect manual, but they are worth summarizing here: 

°WP/B-min—Specifies the number of minutes between each 
automatic backup. 

°WP/D-drive/directory—Redirects the overflow and temporary 
buffer files to the indicated drive and/or directory. 

oWP filename—Starts WordPerfect and automatically retrieves 
the specified file. 

oWP/I drive/directory—Indicates where to find the WP.FIL file, if 
WordPerfect cannot otherwise locate it. 

°WP/M-macro—Executes the named macro after WordPerfect 
loads. 

°WP/NC—Disables cursor speed feature. 

°WP/NE—Inhibits use of expanded memory. 

°WP/NK—Disables enhanced keyboard calls. 

°WP/R—Loads a portion of WordPerfect into expanded memory. At 
least 300K of expanded memory is required or WordPerfect ig- 
nores the request. 

°WP/SS-rows,columns—Specifies the text display of your monitor 
and adapter card. Not used unless WordPerfect cannot automati- 
cally determine the proper setting or if you want to force a change 
in the display parameters. 

¢WP/X—Temporarily cancels changes you have made in the Setup 
menus. When you exit WordPerfect, the previous settings are res- 
tored. 


While you can enter, or switch, each option manually when you 
start WordPerfect, an easier way is to include all the options you 
want to use in a batch file. Suppose, for example, that you want to 
start WordPerfect, indicate a timed backup of every 10 minutes, and 
that you want to load the extra WordPerfect files in the expanded 
memory installed in your computer. Your batch file would contain 


the following: 


wp /b-10 /r 
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Name the batch file WPBAT.BAT, or something similar (but be 
sure to include the .BAT extension). Type WPBAT and press 
[Enter]. Your computer automatically enters the entire command 
line you have specified in the batch file. 

If you are using WordPerfect on a hard disk, you probably have 
the WordPerfect program and its associated files in a subdirectory 
(at least you should). You may find it more convenient to start Word- 
Perfect from the root directory, the starting point for working with 
all your programs. That saves you from changing the directory your- 
self. 

To give you the most flexibility, write the root directory batch so 
that it only changes the directory, then calls up the WordPerfect 
batch file you have already created. Assuming that WordPerfect is 
stored in a subdirectory called WP50, and your startup batch file is 
called WPBAT.BAT, the root batch file contains the following com- 
mand lines: 


cd WP50 
WPBAT 


With this system, you can start WordPerfect from within the root 
directory or within the WP50 directory. Both procedures call up the 
same batch file, so the startup options are identical. You can write 
similar batch files that start WordPerfect from within other sub- 
directories. 

The DOS SET command offers an alternative to setting Word- 
Perfect options. You can enter the SET command directly from the 
keyboard, or include it in a batch file. A likely spot is the 
AUTOEXEC.BAT file, which the computer automatically runs when 
it is first turned on. More about using AUTOEXEC.BAT in the next 
section. 

You use the startup options the same when specified using the 
SET command. The proper syntax is: 


SET wp=(optional switches) 
For example, to set timed backups for every 15 minutes, automati- 
cally retrieve a file named TEST.TXT, and invoke a macro called 


MACRO1 upon startup, you’d enter: 


SET wp=TEST.TXT /b-15 /m-MACRO1 
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AUTOEXEC BATCH FILES 


If an AUTOEXEC.BAT file is present in the root directory of your 
startup disk (hard disk or floppy), your computer will automatically 
execute its contents once the computer has been turned on and DOS 
has loaded. The AUTOEXEC.BAT file is an excellent location for 
DOS commands or programs you want to run every time the com- 
puter is started. There is nothing special, apart from the name, of 
the AUTOEXEC.BAT file. You create and edit it in the same fashion 
as other batch files. 

If all you do on your computer is work with WordPerfect, you may 
want to include command lines within the AUTOEXEC.BAT file to 
run WordPerfect automatically after the computer has started. 
Create the AUTOEXEC.BAT file using the DOS COPY CON; com- 
mand or WordPerfect, as described earlier in this chapter. If you al- 
ready have an AUTOEXEC.BAT file, simply add the WordPerfect 
startup instructions after the existing command lines. 

You'll notice that DOS prompts you for the time and date when 
the computer does not find an AUTOEXEC.BAT file. The prompt 
does not occur if an AUTOEXEC.BAT file is present. If you regular- 
ly set the time and date from DOS, you need to insert it manually, 
using the TIME and DATE commands. Should your computer be 
equipped with a clock board (or multifunction card that includes a 
clock), use the software that came with it to update the time and date 
automatically, each time the computer is turned on. Keep the com- 
mands for running these programs in the AUTOEXEC.BAT file. 


CREATING BATCH FILE MENU SYSTEMS 


The DOS batch feature is woefully inferior to WordPerfect 5.0 
macros. But with a little bit of work, you can create a batch file menu 
system that lets you run programs or routines with just a press of a 
button. The menu system contains the menu list itself, and accom- 
panying action batch files. The action batch files are written so that 
you are always returned to the menu after quitting a program. 

To show you how to build a batch file menu system, create the 
menu shown below. This main menu batch file uses the ECHO com- 
mand which, introduced earlier in this chapter, turns the display on 
and off, and also displays a message to the user. Use WordPerfect to 
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type the following batch code. Save the file as MENU.BAT and place 
it in the root directory. 


MENU.BAT (CHAP18 on Applications Disk) 


ECHO OFF 

CLS 

ECHO. ..-- 

ECHO.... 

ECHO Master Menu 
ECHO.- - - - 

ECHO 1. Start WordStar 
ECHO 2. Start WordPerfect 
ECHO 3. Start Norton Utilities 
ECHO 4. Start QMODEM 
ECHO 5. Start PC Tools 
ECHO 6. Quit for the day 
ECHO: - -- 


The - characters denote blank spaces, and are required when you 
want to use an ECHO instruction to make a blank line. The number 
of spaces isn’t critical but it should be four or more. You need only 
one space when using DOS 3.3 or above. Of course, you can modify 
this menu to include any other task you wish to do. There is no limit 
to the number of items in the menu, although the list should not span 
more than one screen. 


The action macros are numbered from 1 to 6, corresponding to the 
items in the menu. 


¢1.BAT starts WordStar. 
¢2.BAT starts WordPerfect. 
¢3.BAT starts Norton Utilities. 


e4.BAT starts QMODEM (a shareware telecommunications 
program). 


e5.BAT start PC Tools. 


°6.BAT quits for the day; in my computer, the command makes a 


protection copy of the system area of my hard disk, then parks 
the hard disk for safekeeping. 
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When you run MENU.BAT, it displays the menu list, then returns 
to DOS. You then press a number key from 1 to 6 and hit [Enter]. 
The corresponding action macro is then executed. 

The action macros change directories and/or disks, load the 
desired program, then wait until you quit the program to return back 
to the menu. Here’s an example of the command lines for 2.BAT, 
which starts WordPerfect from the root directory: 


ECHO OFF 
cd WP50 
wp 

ECHO OFF 
cd:: 


menu 


The ECHO OFF commands temporarily turn the display off so you 
can’t see the execution of the macro. After leaving WordPerfect, the 
macro returns to the root directory (cd --) and calls up the menu, 
where you can make another choice. 

Note that I use the shortcut method of moving from directory to 
directory. You can change to a subdirectory simply by entering cd, 
a space and the name of the directory. To go back to the next higher 
directory (even if you don’t know its name), type cd - - (don’t forget 
the space between the "cd" and the two periods). This approach to 
working with DOS directories makes planning and writing batch 
files a little easier. 

Menu lists can be contained either in the batch file itself, or ina 
separate text file. You use the DOS TYPE command to display the 
contents of the menu list file. The menu batch file consists of few 


commands: 


ECHO OFF 
CLS 
TYPE MENU.TAT 


By using a text file, you can create menus with special formatting, 
boxes, and UNIQUE characters (depending on the capabilities of 
your monitor and display adapter). You have full control over the ap- 
pearance of the menu, including the location of the items and blank 
lines. The menu document can be created in WordPerfect following 
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the same steps used to make batch files. A sample text menu, using 
graphics created with the Line Draw feature of WordPerfect, is 
shown in Figure 18-1. 


CHANGING THE DOS PROMPT 


Instead of the usual A> or C> prompt you see when you are using 
DOS, you can change the prompt to any character you want. You can 
even add explanatory text or instructions with the DOS prompt. The 
prompt is changed using the PROMPT command. You may enter the 
command directly in DOS or include it in a batch file. Redefined 
prompts are useful when creating batch file menus. 

The PROMPT command is followed by text or by special function 
codes. Each string of text or function code is separated by a $ sign. 
You cannot press the [Enter] key until you are finished defining the 
prompt, so if you want to add additional lines to the prompt, use the 
$_ function code ($ sign followed by one underscore character). 


FIGURE18-1 SAMPLE ENHANCED MENU SCREEN 


È 


Start WordStar 


Start WordPerfect 


Start Norton Utilities 


Start QMODEM 


Start PC Tools 


Quit for the day 


a 
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Here’s a rundown of the function codes you can use to redefine the 


DOS prompt. 


Character 
$t 
$d 
$p 
$n 


Display 

Current time 
Current date 
Current directory 
Current drive 
DOS version 

> character 
<character 

= character 

| character 
Carriage return 
Backspace character (erases previous 
character) 


Here are some examples of modified DOS prompts: 


Prompt 

Hello, Gordon$g 

$p$g 

Welcome to my 
computer$_$n/$p$g 

Select an option and 
press Enter 


Display 

Hello, Gordon> 

directory> 

Welcome to my computer 
drive/directory> 

Select an option and press Enter 


Be sure to begin each definition with the PROMPT command. The 
last example is particularly useful in batch menu systems, Instead 
of the usual DOS prompt, the user is greeted by a message that ex- 
plains what to do next. You can always revert back to the standard 
DOS prompt (A>) by entering PROMPT $n$g. 


BATCH-DRIVEN CONVERT PROGRAM 


One of the more useful applications of batch files is to simplify | 
WordPerfect’s Convert program. Normally, you start the program, 
enter the input file, enter the output file, then specify the type of 
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conversion you want. If you are converting many of the same type of 
program—a bundle of WordStar files to WordPerfect, for example— 
all the steps required to make Convert work can be quite tedious. 

With a batch file, you can reduce the number of keystrokes re- 
quired to convert files. The batch file lets you indicate an input and 
an output file; the rest is automatic. You create several converter 
batch files to complement the types of document conversion you do. 
Here are two sample batch file converters. One converts WordStar 
files to WordPerfect and the other converts WordPerfect files to 
WordStar. 


CONVWS.BAT (CHAP18 directory on Applications Disk) 
ECHO OFF 
REM Convert WordPerfect Documents to WordStar Format 
CLS 
CONVERT %1 %2 1 4 


CONVWP.BAT (CHAP18 directory on Applications Disk) 
ECHO OFF 
REM Convert WordStar Documents to WordPerfect Format 
CLS 
CONVERT %1 %2 4 


The %1 and %2 instructions are command line parameter codes. 
When you type the name of the batch file, you may include up to two 
other pieces of information, and that information is plugged in the 
place of %1 and %2. In this instance, you enter the name of the input 
file and the name of the output file. For example, to convert a file 
named TEXT.1 to TEXT.2, you'd enter: 


CONVWP TEXT.1 TEXT.2 


The batch file sticks the first entry, TEXT.1, into the %1 slot and 
the second entry, TEXT.2, into the %2 slot. DOS accepts up to nine 
of these command line parameter codes. They are numbered con- 
secutively from %1 to %9. 

You can use command line parameters any time you need to supp- 
ly additional information to run a program or DOS command. Note 
that not all programs require or can use supplemental parameters. 
The Convert program can be started by supplying all the necessary 
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information to convert a file in one command line. That’s why the 
batch file can use parameter codes. 

The convert batch files become even more impressive when you 
are converting files that reside on other disks or in other directories. 
Instead of writing the drive and path name each time you want to 
convert files, include the necessary information in the batch file. 
Here’s a batch file that locates the input file in a WordStar directory 
(ws4\docs) and places it in a WordPerfect document subdirectory. 
The Convert program resides in the main WordPerfect directory. 


ECHO OFF 

CLS 

CONVERT \ws4\docs%1 wpdocs\% 2 4 

When running this batch file you need only enter the name of the 
input and output files. The batch file itself adds the necessary direc- 
tory information. 


ACCESSING THE WORDPERFECT DOS SHELL 
WITH MACROS 


WordPerfect allows you to leave the program temporarily and aess 
DOS. The "DOS Shell" feature (not to be confused with the Word- 
Perfect Shell application) lets you take a quick recess to do 
housekeeping chores, such as format diskettes or run a DOS 
program. 

Depending on the amount of memory in your computer and the re- 
quirements of your software, you may even be able to run other 
programs from within the WordPerfect DOS Shell. For example, on 
a 640K IBM PC/XT you can start WordPerfect, leave through the 
Shell (press [Ctrl]-[F1], then press 1) and start WordStar 4.0. To go 
back to WordPerfect, return to the DOS prompt and type EXIT. 

While leaving WordPerfect through the DOS Shell takes only a 
few keystrokes, if you do it often enough you’ll probably want to 
make a macro that simplifies the process. Record the macro as an 
Alt-letter key combination, such as [Alt]-D for (DOS). 
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Key Sequence What it Does 
1. [Ctrl]-[F1] Selects Shell menu. 
2.1 Chooses DOS option. 


If you include other steps in the macro after leaving WordPerfect, 
they are not executed until you come back. This makes it impossible 
for you to write a macro that leaves WordPerfect through the DOS 
Shell, activates a batch file, then returns to WordPerfect. However, 
this "limitation" should give you some ideas about extending the ver- 
satility of macros and batch files. 

For example, say you are converting a series of text files 
downloaded with your telecommunications program. Your macro 
consists of two parts: 


eGo to DOS Shell instructions. 


e Retrieve file, reformat document, and save file instructions. 


Executing the macro first brings you to DOS, where you convert 
one document at a time using a batch file converter specially writ- 
ten for the job. At the end of the batch file is the word EXIT (and a 
hard return), which automatically brings you back into WordPerfect. 
From there, the macro continues by retrieving the file from the disk 
(you have saved it using a specific name), where it proceeds to modify 
the document by removing extraneous characters. At the end, the 
macro pauses and asks you to rename the file. Once the file is safe- 
ly recorded on the disk, the process starts over again. 

You can use the same basic approach for preparing WordPerfect 
documents for telecommunications. Or, you can strip all but the most 
common codes from your documents, then convert them for use on 
other word processors. 

There’s no reason to limit the application of WordPerfect macros 
and DOS batch files to converting files to other formats. You can link 
macros and batch files, for instance, to automatically make two 
copies of a file—one on a hard disk and another on a data disk. 


HANDY DOS BATCH ROUTINES 


By now, you've gotten a good idea of the power and versatility of DOS 
batch files, and how they can be used with WordPerfect. Following 
are several useful batch files that you can use to help relieve the 
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tedium of working with DOS. Feel free to edit these batch files as 
needed. 


Format A Disk 


How many times have you been ready to save a new document only 
to find that you’re all out of formatted floppy disks? This batch file 
lets you format a new disk in any disk drive, and has built-in protec- 
tion to prevent accidentally formatting a hard disk. The batch file 
uses labels, "goto" statements, and command line parameters. Both 
drives C: and D: are locked out as possible hard disks; edit the batch 
file as necessary so that it conforms to your equipment. 


WPFORMAT.BAT (CHAP18 directory on Applicatons Disk) 
ECHO OFF 
IF 41 == . GOTO NOPARAM 
IF %1 == C: GOTO HARDDISK 
IF %1 == c: GOTO HARDDISK 
IF %1 == D: GOTO HARDDISK 
IF %1 == d: GOTO HARDDISK 
CLS 
PATH \ 
FORMAT %1/V 
GOTO QUIT 
-NOPARAM 
ECHO. ..- | 
ECHO You must enter a drive name and colon, such as A:. 
PAUSE 
GOTO TRYAGAIN 
-HARDDISK 
ECHO. --- 
ECHO You can’t format a hard disk with this batch file. 
PAUSE | 
GOTO TRYAGAIN 
‘QUIT 
CLS 
EXIT 
-TRYAGAIN 
CLS 
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Routine labels are preceded by a colon, such as :‘NOPARAM. The 
first IF instruction tests to see if you have provided a drive identifier. 
If you haven’t, then the batch file branches off to the :NOPARAM 
label. The PATH\ command tells DOS where to find FORMAT.COM, 
and the /V switch after the FORMAT instruction forces DOS to allow 
you to add a label to the disk after it has been formatted. 


Copy the Contents of a Subdirectory to a Floppy 
Disk 


This short batch file makes a permanent record of the directory con- 
tents of a hard disk subdirectory. Type the name of the batch file, 
then the name of the subdirectory. The directory list is stored in a 
file called SUBDIR.TXT in the WP50 WordPerfect subdirectory. 


SUBDIR.BAT (CHAP18 directory on Applications Disk) 


ECHO OFF 

IF $1. == .GOTO NOSUBDIR 

CLS 

DIR %1\*.* \WP50\SUBDIR.TXT 

EXIT 

-NOSUBDIR 

ECHO. -.- 

ECHO You must enter a subdirectory to copy. 
PAUSE 

CLS 


List Files on a Disk and Record It In a WordPerfect 
Document 


Instead of taking a snapshot of just the files in a given subdirectory, 
this batch file records the contents of an entire disk, even a disk 
drive. The batch file uses the verbose version of the CHKDSK com- 
mand, and copies the output to a file named CONTENTS.TXT, which 
is placed in the main WP50 WordPerfect directory. A portion of 
sample disk contents file is shown in Figure 18-2. 

Before using the batch file, try the CHKDSK/V command on your 
disk to see if there are any errors. (Do not use the /F CHKDSK op- 
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D: \DOS\SORT. EXE 
D: \DOS\GUBASIC. EXE 
D: \DOS\FIND, EXE 
D:\DOS\ANSI. SYS 
Dt\DOS\CONFIG. SYS 
Directory D:\HOTSHOT 
D: \HOTSHOTNHS. DAT 
D: \HOTSHOTNHS, EXE 
D: \HOTSHOTN\HSINSTAL, EXE 
D: \HOTSHOTNHS. PRT 
D: \HOTSHOTNHS., CFG 
Directory Dt\HAYFILES 
D: \MAYFILES\SOUND, COM 
D!\MAYFILES\VI DEO. COM 
D: \MAYFILES\FIX.COM 
D: \MAYFILES\BACKUP, COM 
Dt\MAYFILES\RECOVER, COM 
D: \MAYFILES\RESTORE,. COM 
D: \MAYF ILES\VERSION. COM 
D:\MAYFILES\NETDISK. SYS 
Directory D:\NORTON 
D: \NORTON\ONEDISK 
D: \NORTONNONEDIR. COM 
D: \NORTON\NSI, COM 


FIGURE 18-2 SAMPLE CHKDSK CONTENTS 


tion from within WordPerfect). If there are errors, have DOS correct 
them (refer to your DOS book on the ramifications of errors). If you 
use the batch file and DOS encounters errors on the disk, the screen 
will remain blank. If this happens, press [Ctrl}-C, and answer Y to 


the prompt. 


CONTENTS.BAT (CHAP18 directory on Applications Disk) 


ECHO OFF 


PATH \ 
CHKDSK/V \WPS0\CONTENTS.TAT 


EXIT 


Set Read-Only Attribute for Any File 


When using DOS 3.0 or above, you may protect any file against ac- 
cidental erasure by using the ATTRIB command. With the ATTRIB 
lock on, a file can be read, but not erased or changed. The ATTRIB 
command is especially helpful when using template documents. Of 
course, you can unlock the file at any time. 
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Two batch files are shown here: one to lock a file and the other to 
unlock it. Type the name of the batch file you want to use, and the 
file name (as well as a drive or subdirectory, if applicable). You can 
test if a file is currently locked or unlocked by typing ATTRIB *.* 
at the DOS prompt. An "R" appears before all files that are locked 
against erasure. Both batch files assume that ATTRIB.COM is lo- 
cated in the root directory. 


LOCK.BAT (CHAP18 directory on Applications Disk) 
ECHO OFF 
CLS 
IF %1. == .GOTO NOPARAM 
PATH \ 
ATTRIB +R %1 
EXIT 
-NOPARAM 
ECHO. ..-- 
ECHO You must enter a file name with the lock command. 
PAUSE 
CLS 


UNLOCK.BAT (CHAP18 directory on Applications Disk) 
ECHO OFF 
CLS 
IF %1. == .GOTO NOPARAM 
PATH \ 
ATTRIB -R %1 
EXIT 
-NOPARAM 
ECHO. .--- 
ECHO You must enter a file name with the unlock command. 
PAUSE 
CLS 


TIPS FOR EFFECTIVE BATCH PROGRAMMING 


Keep these tips in mind when writing your own batch files: 
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eLike every programming language, batch files are best con- 
structed when you think about what you want to do ahead of time. 
Jot down the programs or files you need to access and contemplate 
the best way to introduce them into the batch file. 

eIn all batch files that include command line parameters, provide 
an IF instruction to check that the required parameters have been 
entered. This should be the first IF statement of the batch file or 
DOS may report a syntax error. 

olf you create many batch files, and you are using a hard disk drive, 
create a subdirectory called BATCH and store most or all of your 
batch files in it. 

o Feel free to include explanatory text in your batch files by using 
the ECHO statement. Add blank lines to the batch file by typing 
ECHO, followed by four or five spaces. You can also dress up your 
batch display by adding one or more of the extended characters to 
make a line, box, or other shape. 

Batch files can be used to chain to other batch files. That is, 
BATCHI1.BAT can chain to BATCH2.BAT, and so forth. Unlike 
WordPerfect 5.0 macros, however, batch files cannot be nested. 

eDon’t use the DOS redirection characters < and > with ECHO, 
PROMPT, and PAUSE instructions. DOS will assume the entire 
line, with the redirection characters, is a command. If you must 
use the characters in an ECHO, PROMPT, or PAUSE instruction, 


enclose them in brackets or braces. 
e Double-check the spelling of labels to make sure that they match 
their GOTO counterparts. 


IMPORTANT TOPICS 


eThe main purpose of a batch file is to take the place of manual 
keyboard entry when starting a program or otherwise working 
within DOS. The entries in the batch file correspond to those keys 
you press when you invoke a particular DOS command or start a 
program. 

e Batch files must be saved in ASCII text format only, and not in 
WordPerfect’s normal file format. Use the Text In/Out key to save 
and retrieve batch file documents using WordPerfect. 
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¢Should you with to cancel the execution of a batch, press [Ctrl]- 
C, then answer Y. 


¢Batch files work only up until a program is loaded. Commands or 
text that you have typed after a program has started are ignored 
until you quit the program. Then, the batch file picks up where it 
left off and executes the rest of the instructions. 


e Batch files have their own instructions or keywords. Some of the 
more useful are: 


eECHO, to turn the display on or off, or to display a message. 
CLS, to clear the screen. 

IF, to test for a condition. 

¢GOTO, to jump to a labeled routine in the batch file. 

e PAUSE, to stop to display a message. 

*PROMPT, to change the appearance of the DOS A prompt. 
eREM, to display a message on the screen (ECHO must be on). 


eThe DOS SET command offers an alternative to setting Word- 
Perfect options. Enter the SET command directly from the 
keyboard, or include it in a batch file (such as AUTOEXEC.BAT). 
The proper syntax to use with SET is SET wp=(optional switches} 


eYour computer will automatically execute the contents of the 
AUTOEXEC.BAT FILE once the computer has been turned on and 
DOS has loaded. The AUTOEXEC.BAT file is an excellent loca- 
tion for DOS commands or programs you want to run every time 
the computer is started. 


eThe DOS prompt is changed using the PROMPT command. You 
may enter the command directly in DOS or include it in a batch 
file. The PROMPT command can be followed by text or by special 
function codes. Each string of text or function code is separated 
by a $ sign. You cannot press the [Enter] key until you are 
finished defining the prompt, so if you want to add additional lines 
to the prompt, use the $_ function code ($ sign followed by one un- 
derscore character). 


e WordPerfect allows you to temporarily leave the program and ac- 
cess DOS. The "DOS Shell" feature lets you use batch files without 
having to exit WordPerfect. 


APPENDIX A 


HOW TO USE THE APPLICATIONS DISK 


The Applications Disk contains directories which hold over 230 
macros, styles, templates, and other support files described in this 
book. The files are stored in directories according to the chapter in 
which they appear. The files can be broken down into seven major 


types: 


e Batch files for use with WordPerfect. 

¢Ready-made business letters for use with WordPerfect’s merge 
feature. 

Macros and support files for a unique WordPerfect-based sample 
adventure game. 

¢Keyboard layouts that redefine some of WordPerfect’s keys. 

e All the functional macros developed in this book. 


eSample styles discussed in this book. 
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eText files for use with the various macros. 


Three additional files, not in directories, are used to provide ahelp 
menu system. 


¢HELP.WPM runs the help menu. 


¢HELP.TXT contains the actual text (an adaptation of the appen- 
dix you are now reading). 


¢HELP.BAT refers you to the inside back cover of the book for in- 
formation on using the help system. 


IMPORTANT NOTE: In order for the macros to operate properly, 
the printer file STANDARD.PRS (furnished with WordPerfect) must 
be present in the main WordPerfect disk/directory. See the Introduc- 
tion of WordPerfect 5.0 Macros and Templates for more information 
hardware and software requirements. Additionally, the EXPEN- 
SES.WPM macro requires a special printer definition. See Chapter 
11 for details on what you need to use the EXPENSES.WPM macro. 


USING THE APPLICATIONS DISK 


Before working with the Applications Disk, use DOS to make a back- 
up copy, and store the original in a safe place. You can use the copy 
of the Applications Disk as-is (although some macros may need to be 
modified, as outlined on the next page). Just place the disk in drive 
A: or B: and follow the instructions given in the following sections. 

You can also copy the files onto your hard disk drive. The contents 
of the Applications Disk can be placed into individual subdirectories, 
or in a single subdirectory. We recommend the single directory ap- 
proach. 


Individual Subdirectories 


Move to the WordPerfect directory on your hard disk drive. Make 
new chapter subdirectories to correspond to those on the Applica- 
tions Disk (such as CHAP3, CHAP4, etc.). To create a new directory, 
type MEDIR or MD CHAP#, and press [Enter] (replace # with a 
chapter number). Open the subdirectories on both hard disk and Ap- 


Appendix A 497 


plications Disk in turn and copy the files using the DOS COPY com- 
mand. If you are not sure how to access subdirectories, either from 
within WordPerfect or from DOS, see the “Working with Subdirec- 
tories” section, below. 


Single Subdirectory 


Move to the WordPerfect 5.0 directory on your hard disk drive. Make 
one directory called APPDISK (type MKDIR (or MD) APPDISK, 
and press [Enter]). Open the directory (see “Working With Sub- 
directories” later in this appendix). Place the Applications Disk in 
Drive A: or B:, open each chapter directory in turn, and use DOS to 
copy the contents onto the hard disk drive. 


USING WORDPERFECT MACROS 


How you access the macros will depend on where you put them. 


Macros On the Applications Disk 


To execute macros still on the Applications Disk, press [Alt]-[F10] 
to initiate macro playback, then type the drive that contains the Ap- 
plications Disk, along with the chapter subdirectory, a backslash, 
and the name of the macro you want to use. Finish by pressing 


[Enter]. 
Example: A:CHAP15\DATECODE [Enter] [Alt]-[F10] 


NOTE: The macro will NOT WORK if it calls another macro or text 
file. This is because WordPerfect doesn’t know where to find the 
necessary files it needs to complete the macro (you will get a File Not 
Found message when WordPerfect can’t locate files). There are two 
general solutions to the problem: 


eEdit the macro so that WordPerfect knows where to find it. In- 
clude both the drive and directory, when necessary. Refer to Chap- 
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ter 3 on how to edit macros. Here is an example of an edited macro. 


Original: 
{Retrieve} TEST.TXT(Enter} 
Edited: 
{Retrieve} A:;CHAPI5\TEST.TXT(Enter) 


Change the current default drive and/or directory. The Word- 
Perfect manual provides details on how this is done. Additional 
supplementary information on changing the default directory can 
be found in the “Working With Subdirectories” section at the end 
of this appendix. 


In a Hard Disk Subdirectory 


To execute macros in a hard disk subdirectory, press [Alt]- [F10] to 
initiate macro playback, then type the name of the subdirectory, a 
backslash, and the name of the macro you want to use. Press 


[Enter]. 


Example: APPDISK\DATECODE [Enter][(Alt]-[F10] 


Macros In the Main WordPerfect Directory 


The easy way to play back macros is when they are in the main Word- 
Perfect directory. Press [Alt]-[F10] to initiate macro playback, then 


enter the name of the macro you want to use. Finish by pressing 
[Enter]. 


Example: DATECODE [Enter] [Alt]-[F10] 


You can always tell a WordPerfect 5.0 macro by its .WPM file ex- 
tension. WordPerfect automatically appends this extension to all 
macro files it creates. 


Canceling Macro Execution 


You may quit from most macros by pressing [F1], the Cancel key. 
Some of the macros in this book lock out the [F1] key, and provide 
other means of quitting from the macro. The common alternative 
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methods are [F7] and [Ctrl]-C (the text in the book tells you how to 
operate each macro). 

The display may appear the same after quitting from some macros, 
offering you no visual feedback that the macro has stopped. You can 
test that the macro has been terminated by pressing [Ctrl]-[F10]. If 
the “Define Macro:” prompt appears, WordPerfect has stopped all 
macro execution. Press [F1] to cancel macro definition. 


USING WORDPERFECT TEMPLATES 


WordPerfect templates are files designed for manual or automatic 
fill-in. In most cases, the templates are made to work with 
WordPerfect’s merge feature and act as primary merge documents. 
Fill in the template by creating a secondary data document, then 
starting a merge ([Ctr}]-[F9]. Additional information on creating 
secondary data documents and using WordPerfect’s merge feature 
can be found in Chapter 9. 

Templates designed expressly for merge fill-in have been given a 
.MRG file name extension. You may retain this convention, or 
develop a file record keeping system of your own. 


USING WORDPERFECT STYLES 


Style files are opened using the Style menu (not the List Files or 
Retrieve Text commands). All style files on the Applications Disk 
have been given a .STY extension to make them readily identifiable. 


Styles On the Applications Disk 


When the styles are on the Applications Disk, press [Alt]- [F8] to 
open the Style menu, press 7 for Retrieve, then type the drive that 
contains the Applications Disk, along with the name of the chapter 
directory and the style you want to use. Finish by pressing [Enter]. 


Example: A;CHAPIO\COLUMNS.STY [Enter][Alt]-[F8] 7 
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Styles In a Hard Disk Subdirectory 


To access styles in a hard disk subdirectory, press [Alt]- [F8] to open 
the Style menu, press 7 for Retrieve, then type the subdirectory that 


contains the style files, along with the name of the style you want to 
use. Finish by pressing [Enter]. 


Example: APPDISK\COLUMNS.STY [Enter] [Alt]-[F8] 7 


Styles In the Main WordPerfect Directory 


You can access styles recorded in the main WordPerfect directory by 
pressing [Alt]-[F8] (the Style menu), selecting 7 for Retrieve, then 
entering the name of the style you want to use. Finish by pressing 


[Enter]. 
Example: [Alt]-[F8] 7 COLUMNS.STY [Enter] 


Styles have been given a .STY file name extension. You may retain 
this convention, or develop a file record keeping system of your own. 


USING WORDPERFECT KEYBOARD LAYOUTS 


Keyboard layout files change the behavior of WordPerfect’s keys. 


Several keyboard layout files are provided on the Applications Disk, 
including: 


*WORDSTAR.WPK modifies some of WordPerfect’s control keys to 
act like WordStar cursor movement keys. 


*NEWFUNCT.WPK re-arranges a number of commonly used func- 
tion keys. 


*QUIKKEYS.WPK allows quick and easy access to stored macros 
and this help menu (when you have included it on the WordPerfect 


directory or disk) with the use of redefined control and function 
keys. 


Keyboard layout files use a .WPK file extension. 


Appendix A 601 


To install a keyboard layout file: 


Copy the file onto the main WordPerfect directory (so that it 
resides with the WP.EXE WordPerfect file). 


on WordPerfect, press [Shift]-[F1] to access the Setup menu. 
°Press 6 to select the Keyboard Layout option. 


oFind the layout you want to use from the list that appears and 
highlight it with the cursor keys. 


e Press 1 to select the layout and press the [Enter] key to return to 
the WordPerfect document. 


PLAYING THE ADVENTURE GAME 


The WordPerfect text adventure game uses WordPerfect macros to 
create a workable interactive fiction gaming system. The adventure 
consists of several inter-connected macros and an “object” document. 
Full details of the text adventure can be found in Chapter15. 

To play the game on a hard disk, set the current directory 
to APPDISK (or CHAP15, depending on how you have copied the files 
from the Applications Disk) using the List Files command. 


e Press [F5] and [Enter]. This chooses the List Files command and 
displays the contents of the default drive and directory. 


eLocate the APPDISK directory and select it. 
¢Press 7 to make it the current directory. 


e Finally, press [Enter] twice then strike [E7] to return to the main 
document window. 


Revert to the WordPerfect main directory by following the same 
steps as above, except choose the ARENT directory instead. 

To play the game from the Applications Disk, you must set the cur- 
rent drive to B: (assuming WordPerfect is in drive A:). Do so by press- 
ing [F5], typing B: at the Dir prompt, and striking the [Enter] key. 
Find the CHAP15 directory and follow the steps above to make it the 
current directory. 

Start the game by pressing [Alt]-[F10] and typing ADVENT 
(press [Enter] when done). Quit the game by pressing [F1]. The 
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game documents will remain in Doc 1 and Doc 2. You can view these 
files but you shouldn’t save them. Be sure to clear both documents 
before continuing work with WordPerfect. 


MOVING THE HELP FILES TO A HARD DISK 


If you’d like to access the on-line help system easily from your hard 
disk, copy the HELP.TXT and HELP.WPM files from the Applica- 
tions Disk to the main WordPerfect directory. 

Normally, the help macro asks which drive holds the Applications 
Disk. This prompt allows the macro to access the HELP.TXT file. 
You can delete this prompt by editing the "(CALL}floppy~” instruc- 
tion, located in the beginning portion of the macro. Explanatory text 
within the macro tells you what you need to do. 

The QUIKKEYS.WPK keyboard layout file offers a convenient 
method of calling up the help menu when you have placed the 
HELP.TXT and HELP.WPM files on a hard disk: 


Select the QUIKKEYS.WPK keyboard layout file as explained 
above. 


e Access the help menu by pressing [Ctrl]-[N]. 


WORKING WITH SUBDIRECTORIES 


Subdirectories are convenient “folders” for storing files on a hard 
disk or even a floppy disk. The Applications Disk uses subdirectories 
because it contains so many files. You can access these subdirec- 
tories either with DOS or through WordPerfect. 


Accessing Subdirectories With DOS 


The directories on the Applications Disk are only one level deep; that 
is, all of the chapter subdirectories are located under the main 
("root") directory of the disk. | 


eTo access a chapter directory from the root directory, type: CD 
\CHAP# (replace # with the number of the chapter directory you 
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want to access). Follow the same procedure when accessing a 
chapter directory from within another chapter directory. 


oTo return to the root directory, type: CD \. An alternative is CD 
. (CD, followed by a space and two periods). This latter method 
moves up one directory level at a time. whereas the first method 
brings you all the back to the root directory. 


Accessing Subdirectories With WordPerfect 


WordPerfect provides two basic ways to access files on a subdirec- 
tory: changing the current directory or viewing the directory con- 
tents. Both are potentially confusing. What follows is a short 
summary of the steps involved to access disk subdirectories. 


oTo change the current directory, press [F5], type an = sign, and 
enter the directory, such as CHAP14 (don’t type a backslash), 
Press the [Enter] key twice when done, The contents of the direc- 
tory are shown on the screen. To make the root directory current 
again, repeat the process but type the main WordPerfect directory 
instead. Use a backslash in front of the directory, such as \WP5O. 


oTo simply view the directory contents (and not change the default 
directory), press [F5], and find the directory you want to use 
(directory entries end with a <DIR> in the file list). Select the 
directory and press [Enter] twice. 


NOTE: WordPerfect will return to the current directory on the cur- 
rent drive each time you press the [F5] key, unless you change direc- 
tories using one of the methods outlined above. However, it will not 
return to the root directory if you have viewed the contents of 
another disk. To return to the root directory of that disk, select 
<PARENT> and press the [Enter] key twice. 

You may also change the current directory by selecting the direc- 
tory you want from the list in the List Files menu, and pressing 7. 
Press the [Enter] key twice to accept the choice. 


Accessing Macros 


Changing the default directory may be necessary if you are using a 
macro that calls upon another macro or text file that is not in the 
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current directory (you can avoid this extra step by editing the macro 
using the technique outlined in Using WordPerfect Macros, above). 

If you know that you will be using macros located in another direc- 
tory, you can use DOS to indicate the current default directory. Move 
to the macro directory you want to use from within DOS. You can 
then start WordPerfect by typing \wp50\wp, and [Enter] (assum- 
ing WordPerfect is in the WP50 directory and that you are using DOS 
3.1 or later). 

Another method that works with all versions of DOS is to move to 
the macros directory you want to use and type: PATH \wp50 
[Enter] (again, this assumes that WordPerfect is in the WP50 direc- 
tory). You may now start WordPerfect by typing wp [Enter] at the 
DOS prompt. 

The Location of Auxiliary Files option in the Setup ([Shift]-[F1]) 
menu offers a means to identify the drive and/or directory for macro 
files. Enter the drive and/or directory in the Keyboard/Macro Files 
line (option 3), and press [Enter]. While this allows WordPerfect to 
automatically access all macros located in the drive/directory you 
have indicated, it does not provide a link between a macro and any 
document files the macro may retrieve. Edit the macro as necessary 
so that WordPerfect can find the necessary document files (these in- 
clude text and style files). 


APPENDIX B 


APPLICATIONS DISK CONTENTS 


Root 
CHAP3 
CHAP5 
CHAP6 
CHAP7 
CHAP8 
CHAP9 
CHAP10 
CHAP11 
CHAP12 


<DIR> 
<DIR> 
<DIR> 
<DIR> 
<DIR> 
<DIR> 
<DIR> 
<DIR> 
<DIR> 
<DIR> 
<DIR> 
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Each of the following files is described fully in the book chapter 
corresponding to its directory name. 


CHAPS Directory 
File Name 
NEWFUNCT WPK 


QUIKKEYS WPK 


WORDSTAR WPK 


CHAPS Directory 
File Name 
MENU1 TXT 
MENU2 TXT 
MENUTEST 
FILER WPM 


FULLMENU WPM 


MENUPAGE WPM 
SAVESUB WPM 
SORTMAC WPM 


CHAP6 Directory 
File Name 
APPEND WPM 
AUTOMRG WPM 
AUTOMRG1 WPM 


CHAP7 Directory 
File Name 
STYCHAIN WPM 


CHAP8 Directory 
File Name 
LETFORMT STY 
LETHEAD TMP 


ALTD WPM 


Description 

Re-assignments of some regularly-used 
WordPerfect function keys 

Macro-like short commands for selected 
functions. 

WordStar cursor key equivalent keyboard 
layout file. 


Description 

Template for MENUPAGE.WPM. 
Template for FULLMENU.WPM. 
Sample menu screen for merge menu. 
Saves/retrieves files using 
multiple-level menu prompts. 


Menu driver example; four WordPerfect 
functions. 


Menu driver example. 
Saves files using menu-driven prompts. 
One-line prompt menu driver example. 


Description 

Part of AUTOMRG.WPM. 
Generates secondary merge files. 
Generates secondary merge files. 


Description 
Chains two styles together. 


Description 

Letter format styles. 

Sample letterhead template for 
LETHEAD.WPM. 

Stamps current date. 


ALTZ WPM 
LABEL WPM 
LETFORMT WPM 
LETHEAD WPM 


LETTER WPM 
MEMO WPM 
REPMEMO WPM 
SEMIBLOK WPM 


CHAP9 Directory 


File Name 
BDCHECK MRG 


CHRGREQ MRG 
CONTRACT MEN 
DELAY MRG 
DLYPAY MRG 
DONATE MRG 
LABELPRI MRG 
LETORDER MRG 
LTREMD1 MRG 
LTREMD2 MRG 
LTREMD3 MRG 


MOVING MRG 
NEWACCT MRG 


NOCOD MRG 


ORDER TMP 
ORDPRI MRG 
ORDRPLY TAT 
QUOTE1 MRG 
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Part of REPMEMO.WPM. 

Prints sample boxes letterhead. 
Formats for blocked letter style. 
Generates letters with integrated 
letterhead. 

Calls LETFORMT.STY style. 
Creates memo formats. 

Creates reply memo formats. 
Formats for semi-blocked letter style. 


Description 

Returned check primary merge 
document. 

Charge account request primary merge 
document. 

Contract menu document; part of 
CONTRACT. WPM. 

Delayed shipment primary merge 
document. 

Delayed accounts payable primary merge 
document. 
Declined donation request primary merge 
document. 

Label maker for MRGORD1.WPM. 
Order form primary merge document. 
Late reminder version 1 primary merge 
document. 

Late reminder version 2 primary merge 
document. 

Late reminder version 3 primary merge 
document. 

Were moving primary merge document. 
Welcome new account primary merge 
document. 

No CODs accepted primary merge 
document. 

Crib sheet for ORDRPLY.WPM. 

Part of MRGORD.WPM. 

Forms template for ORDRPLY.WPM. 
Request for quotes version 1 primary 
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QUOTE2 MRG 


RESREPLY MRG 
RESTATE1 MRG 


RESTATE2 MRG 
SOLDOUT MRG 
BEGIN WPM 
CLINQ WPM 
CLORD WPM 
CLOSING WPM 
CONTRACT WPM 
MRGORD WPM 
MRGORD1 WPM 
NOPAY WPM 
NSFPAY WPM 
ORDENC WPM 


ORDRPLY WPM 


PUBRITE WPM 
TYINQ WPM 


TYORD WPM 
WARRANTY WPM 

CHAP10 Directory 
File Name 


COLUMNS STY 
BOXER WPM 


merge document. 

Request for quotes version 2 primary 
merge document. 

Resume replay primary merge document. 
Late reminder statement version 1 
primary merge document. 

Late reminder statement version 2 
primary merge document. 

Item sold-out primary merge document. 
Part of CONTRACT.WPM. 

Part of ORDRPLY.WPM and 
MRGORD.WPM. 

Part of ORDRPLY.WPM and 
MRGORD.WPM. 

Part of ORDRPLY.WPM and 
MRGORD.WPM. 

Generates contracts from boilerplate 
macros. 

Generates automatic boilerplate reply 
letters. 

Generates automatic boilerplate reply 
letters, with labels. 

Part of ORDRPLY.WPM and 
MRGORD.WPM. 

Part of ORDRPLY.WPM and 
MRGORD.WPM. 

Part of ORDRPLY.WPM and 
MRGORD.WPM. 

Creates manual boilerplate reply 
letters. 

Part of CONTRACT. WPM. 

Part of ORDRPLY.WPM and 
MRGORD.WPM. 

Part of ORDRPLY.WPM and 
MRGORD.WPM. 

Part of CONTRACT.WPM. 


Description 
Desktop publishing column sampler. 
Draws boxes around text. 


DEFGRAPH WPM 
DEFHLINE WPM 
DEFTEXT WPM 
DEFVLINE WPM 
DPBOXER WPM 


HEL-B48 WPM 
HELV WPM 


PAL12 WPM 
PAL18 WPM 
SCHOOL24 WPM 


VIEW WPM 


CHAP11 Directory 


File Name 
EXPENSES TMP 
INV TXT 

INVPRI MRG 
ADDTAB WPM 
EXPENSES WPM 
FILLIN WPM 


INVA WPM 
INVB WPM 
INVC WPM 
INVMAC WPMy 
INVOICE WPM 
MRGR WPM 
NEWINV WPM 


CHAP12 Directory 


File Name 
1UPLABEL MRG 
3UPLABEL MRG 
ENVELOPE TMP 
1UPLABEL WPM 
SUPLABEL WPM 
ENVELOPE WPM 


Appendix B 609 


Defines graphics box. 

Defines horizontal line. 

Defines text box. 

Defines vertical line. 

Draws boxes for dummy-page desktop 
publishing design. 

Chooses Helvetica Bold 48 point font. 
Provides menu choice for selecting 
Helvetica fonts in any point size. 
Chooses Palatino 12 point font. 
Chooses Palatino 18 point font. 
Chooses New Century Schoolbook 24 
point font. 

Switches to Print View. 


Description 

Template for EXPENSES.WPM. 
Invoice template for INVOICE.WPM. 
Invoice template for INVMAC.WPM. 
Part of INVMAC.WPM. 

Prepares employee expense reports. 
Fills-in pre-printed statement/invoice/ 
receipt. 

Part of INVOICE.WPM. 

Part of INVOICE.WPM. 

Part of INVOICE.WPM. 

Produces invoices. 

Produces letter-style invoices. 

Part of INVMAC.WPM. 

Creates letter style invoice. 


Description 

Template for LUPLABEL.WPM. 
Template for 3UPLABEL.WPM. 
Template for EXPENSES.WPM. 
Prints labels on one-up stock. 
Prints labels on three-up stock. 
Prints on envelope forms (includes 
return address). 
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ENVGRAPH WPM 


PRLABEL WPM 
PRLABEL1 WPM 


CHAP13 Directory 


File Name 
RESUME1 TMP 
RESUME1 WPM 
RESUME2 WPM 
RESUME3 WPM 
RESUME4 WPM 


CHAP14 Directory 


File Name 
DIALOG STY 
OPENSP STY 
AUTOSP2 WPM 


BOLD WPM 
CENTAB WPM 
CENTER WPM 
CENTERED WPM 


CENTERST WPM 
CHAR WPM 
CONVERT WPM 


COPY WPM 

CUT WPM 
DELPAR WPM 
DELSENT WPM 
DOUBLE WPM 
ENDNOTE WPM 
ENDNUM WPM 


ENDPLACE WPM 
FONTSIZE WPM 


Prints on envelope form (with graphics 
in the return address). 

Prints labels. 

Prints labels. 


Description 

Template for RESUME#.WPM. 
Builds skill-format resume. 

Builds enhanced skill-format resume. 
Builds chronological-format resume. 
Builds resume without name/address 
template. 


Description 
Hollywood-style script format. 
Open space between paragraph format. 
Sample macro for automatically adding 
open space between all paragraphs. 
Bolds already written text. 
Centers text at a tab stop. 

enters already written text. 
Centers a line of previously written 
text (cursor at the end of the line). 
Centers a line of previously written 
text (cursor at the start of the line). 
Formats text for dialogue entry for 
Hollywood-style screenplays. 
Converts tab delimited files to 
secondary merge document format. 
Copies selected text. 
Cuts selected text. 
Deletes paragraph. 
Deletes sentence. 
Sets spacing to double. 
Creates a new endnote, 
Restarts or redefines endnote 
numbering. 
Places endnote code and generates notes. 
Changes font size of already written 


FONTSTYL WPM 


FOOTNOTE WPM 
FOOTNUM WPM 


HANGIND WPM 
HEAD WPM 
HEADER WPM 
INDEX1 WPM 


INDEXWRD WPM 


MARKIND WPM 
MARKTOC WPM 
OFFAHEAD WPM 
ONEHALF WPM 
OPEN1 WPM 
OUTLINE WPM 
OUTLINE1 WPM 
PARNORM WPM 
PARSYMB WPM 


PASTE WPM 
RMHRT WPM 
SINGLE WPM 
SIZE WPM 
SPTOTAB WPM 
STRIP1 WPM 


STRIP2 WPM 


STRIPR WPM 
STRIPCOM WPM 


STRIPTAB WPM 
STYLE WPM 


SUB WPM 
SUPAFOOT WPM 
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text, 

Change font style of already written 
text. 

Creates a new footnote. 

Restarts or redefines footnote 
numbering. 

Creates a hanging paragraph indent. 
Header prefix. 

Opens a new A header. 

Marks word for index, allows for new 
heading and subheading for initial 
entry. — 

Marks word for index, allows for new 
heading and subheading for each entry. 
Marks word for index. 

Marks line for table of contents. 
Turns header A off. 

Sets spacing to one and a half. 

Adds open space between paragraph. 
Runs an outline. 

Runs an outline. 

Hides paragraph hard return symbols. 
Shows hard returns as paragraph 
symbols. 

Pastes previously cut or copied text. 
Removes hard carriage returns. 

Sets spacing to single. 

Change font size before writing text. 
Converts spaces to tabs. 

Replaces merge codes for comma 
delimited files. 

Replaces merge codes for tab delimited 
files. 

Strips “R merge codes. 

Strips commas to make secondary 
merge document. 

Strips tabs to make secondary merge 
document. 

Changes font style before writing text. 
Sets following text as subscript. 
Suppresses A footer. 
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SUPAHEAD WPM 
SUPBFOOT WPM 
SUPBHEAD WPM 
SUPER WPM 
TALK WPM 


TEST1 WPM 
TOSOFT1 WPM 


TOSOFT2 WPM 
UNDERLN WPM 


CHAP15 Directory 


File Name 
ADVENT TXT 
ANSWERS TXT 


GOTTADO TMP 
PROVERB TXT 


RIGHT FMT 


ROUTSLIP TMP 
TODO TXT 
ADVENT WPM 
ALTM WPM 


BACKPR1 WPM 
BACKPR2 WPM 
BACKPR3 WPM 
BOX WPM 


CLS WPM 

DATE WPM 
DATECODE WPM 
DELPHN WPM 
DROP WPM 


EXAMINE WPM 


Suppresses A header. 

Suppresses B footer. 

Suppresses B header. 

Sets following text as superscript. 
Sampler for automatic entry of 
character name in Hollywood-style 
screenplay. 

Header/footer body (for use with 
HEAD.WPM). 

Removes hard returns within a block. 
Removes hard returns within a block. 
Underlines already written text. 


Description 

Adventure game room object file. 

Question/answer sheet for 

QUIZ.WPM. 

Sample form made with Line Draw. 

Proverb template, part of 

PROVERB.WPM. 

Leading tab format document, for use 
with TABLEAD.WPM. 

Sample form made with Line Draw. 

Template document for TODO.WPM. 

Main adventure game driver. 

Starts a macro from the MACROS\ 

directory. 

Prints document backwards. 

Prints document backwards. 

Prints document backwards. 

Draws a box of a specified 

dimension. 

Clears the document window. 

Stamps current date. 

Stamps current date code. 

Deletes phone messages; part of 

WHILEOUT.WPM. 

Drop object macro, part of 

ADVENT. WPM. 

Examine object macro, part of 


GET WPM 
INVENT WPM 


LINE WPM 
LINEACRS WPM 


LINEHOR WPM 
LINEVER WPM 
LOOK WPM 
MACLIST WPM 
PARNUM WPM 
PARNUM1 WPM 
PRINTPHN WPM 
PROVERB WPM 
PRPAGE WPM 
QUIKCALC WPM 
QUIZ WPM 
QUIZ1 WPM 
RECDEL WPM 


RESCREEN WPM 
ROOMO WPM 


ROOM1 WPM 
ROOM2 WPM 
ROOM3 WPM 
ROOM4 WPM 


ROOM5 WPM 
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ADVENT.WPM. 

Get object macro, part of 
ADVENT.WPM. 

Inventory macro, part of 
ADVENT.WPM. 

Creates graphic line. 

Draws a horizontal line from margin to 
margin. 

Draws horizontal lines. 

Draws vertical lines. 

Look room/object macro, part of 
ADVENT.WPM. 

Lists macro files on current 
disk/directory. 

Automatically numbers paragraphs. 
Automatically numbers paragraphs, 
Prints phone messages, part of 
WHILEOUT. WPM. 

Prints a proverb or saying (using 
RPOVERB.TXT). 

Prints selected pages. 

On-screen calculator. 


. Quiz game driver. 


Quiz game driver. 

Deletes selected record from 
secondary merge document. 
Resets screen after split. 
Room 0 macro, part of 
ADVENT.WPM. 

Room 1 macro, part of 
ADVENT. WPM. 

Room 2 macro, part of 
ADVENT.WPM. 

Room 3 macro, part of 
ADVENT. WPM. 

Room 4 macro, part of 
ADVENT.WPM. 

Room 5 macro, part of 
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ADVENT.WPM. 

RULEROFF WPM Hides ruler. 

RULERON WPM Shows ruler. 

SAVE WPM Quick save of document. 

SCRMEMO WPM Electronic note pad, unswitched. 

SORTDIR WPM Sample record sorter. 

SPSCREEN WPM Splits screen. 

SWMEMO WPM Electronic not pad, switched. 

TABLEAD WPM Prints leading tabs for manually 
prepared lists and tables. 

TIME WPM Stamps current time. 

TIMECODE WPM Stamps current time code. 

TIMETRAK WPM Tracks elapsed time (hours and minutes). 

TODO WPM Makes a to-do list. 

WDCOUNT WPM Counts the number of words in the 
current document. 

WHILEOUT WPM While-you-were-out telephone pad. 

WHILOUT1 WPM Enhanced while-you-were-out telephone 
pad. 

CHAP 16 Directory 

File Name Description 

AND WPM Tests for AND logical operation. 

OR WPM Tests for OR logical operation. 

CHAP18 Directory 

File Name Description 

CONTENTS BAT Records the contents of the disk. 

CONVWP BAT Converts Wordstar files to WordPerfect 
files. 

CONVWS BAT Converts WordPerfect files to 
WordStar files. 

LOCK BAT Locks files against accidental erasure. 

MENU BAT DOS menu driver. 

SUBDIR BAT Records the contents of a subdirectory. 

UNLOCK BAT Unlocks files. 

WPBAT BAT Starts WordPerfect with 
PROVERB.WPM macro. 


WPFORMAT BAT Formats a floppy disk. 
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EXTRAS Directory (these macros are not described in the book, 
but are provided on the Applications Disk for your convenience). 


File Name Description 

COUNT WPK Counts the number of times a word 
appears in a document. 

FINDNOTE WPK Finds endnotes and displays them. 

ORIGLINE WPK Draws lines in Line Draw without adding 
the arrow heads. 

PAGEBRK WPK Displays a document one page at a time, 
showing the breaks between adjacent 
pages, 

RESCREEN WPK Resets the current window display to 24 
lines. See also SPSCREEN.WPM. 

RULEROFF WPK Turns the margin/tab ruler off. 

RULERON WPK Turns the margin/tab ruler on. 

SPSCREEN WPK Splits the window display in two 


(showing Doc 1 and Doc 2 
simultaneously). See also 
RESCREEEN.WPM. 

TIMETRAK WPK Tracks time spent in meetings or while 
on the phone, without having to quit 
WordPerfect or abandon the 
current job. Press [Ctrl]-S to stop 
the clock. WordPerfect records the 
meeting or phone call in a log book, 
in a file specified by the entry you 
make for the "Name field (you can 
change the macro to save the file by 
‘account number or any other entered 
field). TIMETRAK.WPM can't be used 
for meetings or phone calls that span 
over one day. 


Index 


A ANSWERS.TXT, 381 
ADDTAB.WPM, 268 Applications Disk 
Adventure games, 408-413 adventure game, 501-502 
Applications Disk, 501-502 categories of files, 495-496 
listing of macros, 410-411 contents of, listing by chapter, 505-515 
maps, 411-412 help files, moving to hard disk, 502 
parser in, 409-410 keyboard layouts, 600-501 
variables used, 411 macros, execution of, 497-498 
ALTD.WPM, 170-171 styles, 499 
Alt-letter macro subdirectories, 602-504 
chaining, 58-59 templates, 499 
editing, 55, 58-59 use of, 496-497 
ALTM.WPM, 395 individual subdirectories, 496-497 
AND/OR operators single subdirectory, 497 
AND.WPM, 444-445 Arguments, following programming 
OR.WPM, 444-445 statements, 64 
truth tables, 83-84, 445 (ASSIGN) variable~value~, programming 
uses of, 85-86 statement, 66 


use with numbers, 83 
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Automatic repeat, merge entry 
templates, 129-130 
AUTOMERG.WPM, 132-135 
AUTOMERG.WPM1, 135-136 
AUTOMRG.WPM, 179 


B 
Backups, of macros, 419-420 
Backwards printing, 405-407 
BACKPR1.WPM, 406 
BACKPR2.WPM, 407 
BACKPR3.WPM, 407 
Bad checks letter, 184, 187, 188 
Batch files, 475-494 
AUTOEXEC.BAT, 481 
convert batch files, 485-487 
copy subdirectory contents to floppy, 
490 
creation of, 476-477 
from DOS with COPY command, 
476-477 
from WordPerfect, 477 
DOS prompt, changing, 484-485 
DOS shell, accessing, 487-488 
editing of, 477 
execution of, 477-478 
format disk, 489 
list files on disk/record in Word- 
Perfect, 490-491 
locking/unlocking files, 491-492 
menu systems, 481-484 
MENU.BAT, 482-483 
programming tips, 492-493 
purpose of, 476 
for starting WordPerfect, 478-480 
BDCHECK.MRG, 184, 187, 188 
BEGIN.WPM, 226 
(BELL), programming statement, 67 
Billing, 122-128 
See also Invoices. 
Binary numbers, equivalents to decimal 
numbers, 84-85 
Blank spaces, manual-entry templates, 
121-124 


Block command, beeping of computer 
and, 464-465 
Blocked letters, 162-164 
examples, 163-164 
Boilerplate business correspondence, 
177-230 
contracts, 221-231 
customer notices, 180-190 
field entry conversion, 180 
merged template documents, 178-179 
AUTOMRG.WPM, 179 
secondary merge documents, 179- 
180 
orders for products, 194 
LETORDER.MRG, 194, 196-197 
quotes for services/products, 191, 194 
QUOTE1.MRG, 191, 193 
QUOTE2.MRG, 194, 195 
reply letters, 197-221 
requests, CHRGEQ.MRG, 191, 192 
See also specific types of correspon- 
dence. 
Boilerplate document assembly, merge 
entry templates, 130 
Boilerplate files, setting up, 172 
Bold-face, 354 
BOLD.WPM, 354 
BOXER.WPM, 253 
Boxes 
BOX.WPM, 399 
choices for, 239 
defining, 239-242 
drawing, 398-399 
{BREAK}, programming statement, 67 


C 
Calculations 
expense reports, auto-calculated, 278- 
288 
invoices 
auto-calculated invoices/statements, 
262-271 
semi-automatic, 261-262 
Calculator, 379-881 


QUIKCALC.WPM, 379-381 
{CALL)label~, programming statement, 
67 
Canceling macros, 15, 415, 498-499 
(CANCEL OFF), programming state- 
ment, 67 
(CANCEL ON}, programming state- 
ment, 67 
{CASE CALL}value~casel~labell~... 
case#~label#~~, programming state- 
ment, 68 
(CASE) value~case1~label1l~...case#~label 
#~~, programming statement, 68 
Centering text, 356-358 
already written text, 356 
CENTAB.WPM, 358 
CENTERED.WPM, 358 
CENTERST.WPM, 357 
CENTER.WPM, 356 
previously written text, 357-358 
starting at tab stop, 358 
Chaining, 25-33, 470 
advantages to use, 25 
Alt-letter macro, 58-59 
conditional chains, 31-33 
macros in, 32 
steps in, 32-33 
macro linker, 27-28 
steps in, 27-28 
use of, 26-27 
repeating chains, 29-31 
steps in, 30-31 
uses of, 29-30 
steps in, 25-26 
style chains, 150-152 
tips for, 422 
(CHAIN)macro~, programming state- 
ment, 68 , 
{CHAR}variable~message~, program- 
ming statement, 68 
CHRGEQ.MRG, 191, 192 
Clearing document, 423 
CLINQ.WPM, 211 
CLORD.WPM, 211 
CLS.WPM, 394-395 
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Codes and symbols, manual-entry 
templates, 124 
Color graphics adapter (CGA), desktop 
publishing, 232 
Columns 
column styles, listing of, 235-287 
formatting codes, adding, 237 
Comments 
creation of, 125 
manual-entry templates, 125 
Conditional chains, 31-33 
macros in, 32 
steps in, 32-33 
CONTENTS.BAT, 491 
Contracts, 221-231 
adding data, 229 
automatic referencing, 223-224 
CONTRACT.WPM, 221, 223-226 
duplicate lines, 228 
menu features, 223 
menu list, 224-226, 226 
highlighting by macro, 226 
paragraph numbering, 227 
sub-macros, 226-230 
BEGIN.WPM, 226 
as nested macros, 227 
PUBRITE.WPM, 228 
WARRANTY.WPM, 229 
Control characters, listing of, 77-78 
CONVERT.WPM, 368 
CONVWP.BAT, 486 
CONVWS.BAT, 486 
Copy text block to buffer, 352-353 
COPY.WPM, 342-353 
Counters, 437-438 
uses of, 437 
Customer notices, 180-190 
field entry conversions, 180 
late reminder letter 
LTREMD1.MRG, 181, 182 
LTREMD2.MRG, 181, 182 
RESTATE1.MRG, 184, 185 
RESTATE2.MRG, 184, 186 
moving announcement, 187 
MOVING.MRG, 187, 189 
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new account, 187, 191 


NEWACCT.MRG, 187, 190 
unpaid checks, 184, 187 
BDCHECK.MRG, 184, 187, 188 


Custom menus, 89-112 


full-page menu, 90-99 

deleting menu list, 97-99 
FULLMENU.WPM, 95-97 
menu engine, writing, 90-94 
MENUPAGE.WPM, 92-94 
redefining existing macro, 90-91 


isolating macro routines, 458-460 
mistakes to look for, 457-458 
(ON ERROR} statement, use of, 464 
Decimal numbers, binary equivalents 
to, 84-85 
Defaults, standard, return to, 423 
Delete paragraph, 352 
Delete sentence, 352 
DELPAR.WPM, 342 
DELPHN.WPM, 378-379 
DELSENT.WPM, 342 


multiple-line menu prompt, 106-108 

on-line menu prompt, 99-106 
FILER.WPM, 104-106 
multiple-level, 103-106 
SAVESUB.WPM, 102-103 
SORTMAC.WPM, 99-102 

Cut text block/place in buffer, 353 
CUT.WPM, 353 


D 
Date 
date stamp macro, DATE.WPM, 392- 
893 
letters, automatic insertion, 170-171 
Debugging, 457-474 
common problems 
beeping computer, 464-465 
blank screen, 466-467 
garbled screen, 470-471 
halted execution, 467 
key reassignment malfunction, 471 
macro not found, 470 
macro stops during merge, 472 
missing {RETURN}, 467 
missing {ELSE} and (END IF}, 466 
missing WP.MRS file, 472 
quotation marks and variable state- 
ments, 465 
run-on subroutines, 466 
search not found, 467-468 
slow performance, 473 
tilde (~), problems with, 472 
variable numbers, errors in, 468-469 
error messages, 460-464 


Desktop publishing, 231-253 


columns, 233-237 
column styles, listing of, 235-237 
formatting codes, adding, 237 
dummy-page design macro, 250-253 
BOXER.WPM, 253 
DPBOXER.WPM, 250-253 
font selection, 245-249 
displaying all choices, 246-249 
HEL-B48.WPM, 246 
HELV.WPM, 247-249 
PAL12.WPM, 246 
PAL18.WPM, 246 
point size, 246 
SCHOOL24.WPM, 246 
graphics boxes 
choices for, 239 
defining, 239-242 
hardware requirements, 232-233 
color graphics adapter (CGA), 282 
enhanced graphics adapter (EGA), 
232 
Hercules graphics card, 232 
laser printers, 233 
video graphics array (VGA), 232 
lines 
defining, 242, 244 
horizontal, 244 
vertical, 244 
templates, 237-239 
creation of, 238 
defining text in box, 239 
graphics boxes, choices for, 239 
setting placement of page, 239 


standing elements, 237, 239 
viewing document, 244-245 
VIEW.WPM, 245 
Display 
AP 
pop-up windows, creating, 450-453 
use of, 448-450 
hiding display, 23 
listing of display codes, 41-42 
turning on/off, 23, 68, 69 
{DISPLAY OFF), programming state- 
ment, 68 
{DISPLAY ON}, programming state- 
ment, 69 
Document assembly 
automatic 
auto-assemble template, 215 
MRGORD.WPM, 215-218 
ORDPRI.MRG, 212 
sample assembled documents, 213, 
214 
boilerplate document assembly, merge 
entry 
templates, 130 
Document conversion 
batch files for, 485-488 
hard carriage returns, revealing, 359- 
361 
secondary merge files, 364-368 
adding merge codes to tab-delimited 
files, 368 
comma-delimited files converted to, 
367 
conversion to line/column format, 
365-366 
CONVERT.WPM, 368 
hard returns changed to com- 
mas/tabs, 366-367 
STRIP1.WPM, 365-366 
STRIP2.WPM, 366 
STRIPCOM.WPM, 367 
STRIPTAB.WPM, 367 
tab-delimited files converted to, 367 
standard documents, 361-364 
alternative hard return remover, 
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863-364 
block removal, hard returns, 363 
hard return remover macro, 362-363 
reasons for conversion, 362 
space-to-tab converter macro, 362 
Documents 
formatting, styles, 139-164 
moving data between, 438-440 
DOS shell, accessing, 487-488 
DPBOXER.WPM, 250-253 


E 
Editing 
keyboard remapping 
editing keyboard layout, 44 
editing keys, 44-46 
See also Macro editing; Writing/edit- 
ing. 
(ELSE), programming statemont, 69 
(END IF}, programming statement, 69 
Endnotes. Seo Footnotes/endnotes 
ENDNOTE.WPM, 334 
ENDPLACE.WPM, 334 
Enhanced graphics adapter (EGA), 
desktop publishing, 232 
(Enter), programming statement, 69 
Envelopes, 299-802 
ENVELOPE.WPM, 300-301 
fonts, 301-302 
graphics envelope template, 302-304 
ENVGRAPH.WPM, 302-304 
Erasing macros, 12 
prevention of, 118-119 
Error messages 
access denied, 460 
file not found, 460 
Errors. See Debugging 
Expense reports (auto-calculated), 278- 
288 
template for, 278, 280-281 
EXPENSES.TMP, 278, 280-281, 282- 
288 
information entered, 281 
mileage, 281-282 
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printer for, 278, 281 
specific formatting for, 281 
Extended character set, IBM, 250 


F 
Field entry conversion, business letters, 
180 
FILER.WPM, 104-106 
Flow chart, use in programming 
macros, 33-35 
Font attribute characters, listing of, 78, 
80 
Fonts 
font size, changing 
already written text, 355 
before writing, 356 
FONTSIZE.WPM, 355 
font style, changing 
already written text, 355 
before writing, 356 
FONTSTYL.WPM, 355 
printing envelopes, 301-302 
selection of, 245-249 
displaying all choices, 246-249 
HEL-B48.WPM, 246 
HELV.WPM, 247-249 
PAL12.WPM, 246 
PAL18.WPM, 246 
point size, 246 
SCHOOL24.WPM, 246 
Footers. See Headers/footers 
Footnotes/endnotes, 333-335 
endnote placement, 
ENDPLACE.WPM, 334 
ENDNOTE.WPM, 334 
FOOTNOTE.WPM, 333 
numbering, FOOTNUM.WPM, 334 
options menu, 335 
renaming macros, 333 
Format disk, 489 
Format templates, 119-120 
uses of, 120 
Forms, 20 
FILLIN.WPM, 271, 273-278 


format codes, 277-278 
FULLMENU.WPM, 95-97 


G 

GENERATE.WPM, 348 

(GO}label~, programming statement, 69 
Graphics boxes. See Boxes 

Graphics envelope template, 302-304 


H 
HANGIND.WPM, 358 
Hanging paragraph indent, 358 
Headers/footers, 327-332 
defining new header/footer, 
HEADER.WPM, 327-328 
macro "prefixes" for 
examples of, 332 
HEAD.WPM, 331-332 
TEST1.WPM, 331-332 
suppressing 
SUPAFOOT.WPM, 330 
SUPAHEAD.WPM, 329 
SUPBFOOT.WPM, 330 
SUPHEAD.WPM, 330 
turning off, OFFAHEAD.WPM, 329 
HEL-B48.WPM, 246 
HELV.WPM, 247-249 
Hercules graphics card, desktop publish- 
ing, 232 
Hierarchies, style, construction of, 152- 
153 


I 
IF. . .ELSE statements 
constructing AND and OR logic with, 
444- 446 
correct execution of, 466 
menu writing, 93, 97, 107 
simplification of, 442-444 
(IF EXISTS) variable~, programming 
statement, 71 
{If)value~, programming statement, 70 


Importing text 
problems with, 359 
See also Document conversion. 
Indention, letters, automatic for first- 
line, 166-167 
Index preparation, 348-352 
INDEX1.WPM, 351-352 
INDEXWRD.WPM, 349-350 
MARKIND.WPM, 349 
marking index, 348-349 
for heading/subheading, 349-351 
INVA.WPM, 257, 258, 259 
INVB.WPM, 257, 258, 259 
INVC.WPM, 258, 259 
INVMAC.WPM, 266-271 
Invoices, 256-271 


auto-calculated invoices/statementa, 


262- 271 
ADDTAB.WPM, 268 
formats for, 264-265 
INVMAC.WPM, 266-271 
INVPRI.MRG, 266 
limitations of, 271 
MRGR.WPM, 268 
steps in, 269-270 
templates, 262, 266 
letter-style invoices, 256-262 
INVA.WPM, 257, 258, 259 
INVB.WPM, 257, 258, 259 
INVC.WPM, 258, 259 
INVOICE.WPM, 256-259 
nested macro invoice, 256-259 
NEWINV.WPM, 261 
page formatting, 256 
semi-automatic tally, 261-262 
single-macro invoice, 259-262 
template for, INV.TXT, 256, 257 
INVOICE.WPM, 256-259 
INVPRI.MRG, 266 
INV.TXT, 256, 257 


K 
Keyboard layouts 
Applications Disk, 500-501 
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installing file, 501 
Keyboard looping, 427-428 
Keyboard remapping, 42-52 
assigning macros to keys, 47 
case, accepting upper/lower case, 429 
choosing layout by macro, 48 
creating new layout, 44 
deleting keys, 46 
editing keyboard layout, 44 
editing keys, 44-46 
malfunctions, 471 
moving keys, 46 
NEWIUNCT.WPK layout, 51-52 
opening existing layout, 43 
original layout, reverting to, 48 
QUIKKEYS.WPK layout, 51 
redefining keys, during macro execu- 
tion, 428-429 
saving keys as macros, 47 
selecting keyboard layout, 47-48 
WordStar equivalent keys, 48-50 
Key commands, listing of, 462-464 
Keystrokes, repeating keystrokes, 440- 
441 


L 
{LABEL)label~, programming state- 
ment, 71 
Labels 
one-up labels, 290-297 
adjusting printer, 297 
direct printing, 290-294 
merge printing, 295-297 
LUPLABEL.MRG, 295-296 
PRLABEL1.WPM, 293-294 
PRLABEL.WPM, 291-293 
reply letters, 218-221 
LABELPRI.MRG, 220-221 
LABELSEC.MRG, 220 
MRGORD1.WPM, 218 
MRGORD.WPM, 219 
primary label document, 218-219 
three-up labels, 297-299 
adjusting printer, 299 
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laser printers, 299 
3UPLABEL.MRG, 298-299 

Labels (within macros), 63, 430 
naming, 421 

Laser printers 
desktop publishing, 233 
font selection, 245-249 
labels, 299 
See also Fonts. 

Late reminder letter 
LTREMD1.MRG, 181, 182 
LTREMD2.MRG, 181, 182 
RESTATE1.MRG, 184, 185 
RESTATE2.MRG, 184, 186 
three versions of, 181, 184 

Leader dots 
automatic, 389-391 

and RIGHT.FMT file, 390 
TABLEAD.WPM, 389-390 

LETFORMT.WPM, 160-161, 167 

LETHEAH.WPM, 169-170 

LETORDER.MRG, 194, 196-197 

LETREMD2.MRG, 181, 182 

Letters, 160-172 
blocked letters, 162-164 

examples, 163-164 
boilerplate files, setting up, 172 
complimentary close, automatic inser- 
tion, 171-172 
date 
ALTD.WPM, 170-171 
automatic insertion, 170-171 
indention, automatic for first-line, 
166- 167 
letterhead, 169-170 
LETHEAH.WPM, 169-170 
LETTER.WPM, 161-162 
macro formats 
LETFORMT.WPM, 160-161, 167 
settings for, 160 
merged letters, 172 
semi-blocked letters, 165-169 
example, 165 
SEMIBLOK.WPM, 167 
storing formats as style, 161-162 


See also Boilerplate business 
correspondence; Reply letters. 
Library style, 147-149 
Lines, 395-396 
defining, 242, 244 
horizontal/vertical, 244 
defining number/spacing/length, 395 
LINEHOR.WPM, 395-396 
dummy-page design macros, 250-253 
BOXER.WPM, 253 
DPBOXER.WPM, 250-253 
line across, 396-398 
LINEACRS.WPM, 398 
and printer compatibility, 400 
vertical lines (specific length), 395-396 
LINEVER.WPM, 396 


Line spacing, 322-327 


AUTOSP2.WPM, 325 
double-space, 323 
one-and-a-half-space, 322-323 
open space, 323-327 
automatic open space, 324, 325, 336 
manual open space, 324 
OPEN1.WPM, 324 
open space style, 326-327 
OPENSP.STY, 327 
single space, 322 


List manager, secondary merge files, 


404-405 


LOCK.BAT, 492 
{(LOOK}variable~, programming state- 


ment, 71 


LTREMD1.MRG, 181, 182 


M 

MACLIST.WPM, 394 

Macro Command key, uses of, 52-53 
Macro editing, 39-42, 52-60 


Alt-letter macro, 55, 58-59 
chaining, 58-59 

assessing macro editor, 39-40, 53 

display codes, listing of, 41-42 

editing keys, control of, 55 

limitations, 55 


macro editing window, getting to, 53- 
54 
one-line description, 54 
steps in, 54 
Macro levels, 65-66 
importance of, 66 
maximum number, 65 
and subroutines, 65, 66 
Macro linker 
steps in, 27-28 
use of, 26-27 
Macro programming, 61-87 
control characters, listing of, 77-78 
flowchart, use of, 33-35 
font attribute characters, listing of, 78, 
80 
labels, use of, 63 
and macro editing window, 63 
programming statements, 63-64 
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(ON CANCEL)command~, 72 
(ON ERROR)command-~, 73 
(ON NOT FOUND)command-~, 73 
(ORIGINAL KEY}, 73 
(PAUSE), 78 

(PROMPT) message~, 73-74 
(QUIT), 74 

(RESTART), 74 

(RETURN), 74 

(RETURN CANCEL}, 75 
(RETURN ERROR}, 75 
(RETURN NOT FOUND), 75 
(;)comment~, 66 
(SPEED}1/100th secs.~, 75 
(STATE), 75-76 

(STEP ON), 76 

(TAB), 77 
{TEXT)variable~message~, 77 
(WAIT) 1/10th socs.~, 77 


accessing, 63-64 

arguments following, 64 
(ASSIGN) variable~value~, 66 
(BELL), 67 

(BREAK}, 67 

(CALL)label~, 67 

(CANCEL OFF), 67 
{CANCEL ON}, 67 

{CASE CALL) value~case1~label1~... 
case#~label#~~, 68 

(CASE) value~case1~labell-... 
case#~labeli#~~, 68 

(CHAIN) macro~, 68 

{CHAR} variable~message~, 68 
(DISPLAY OFF}, 68 
(DISPLAY ON}, 69 

(ELSE), 69 

(END IF}, 69 

(Enter), 69 

entering into macro, 64-65 
{(GO)label~, 69 

{IF EXISTS)variable~, 71 

{IF} value~, 70 
(LABEL)label~, 71 
{LOOK)variable~, 71 
(NEST}macro~, 72 


strings, 63 
subroutines, 63 
tilde character (~) in, 64 
variables, 80-86 
AND/OR operators, 83-86 
assigning values, 80-81 
multiple operators, 86 
operators with variables, 82-86 
text strings, using, 86 
Macros 
accessing macros 
Applications Disk, 497-498 
hard disk subdirectory, 498 
WordPerfect directory, 498 
advanced features 
chaining, 25-33 
hiding displays, 23 
macro sets, 24 
pausing macros, 19-22 
programming flow chart for, 33-35 
backup copies of, 419-420 
canceling of, 15, 421, 498-499 
command numbers, 461 
creation of, example, 12-14 
defining, steps in, 5-6 
erasing/redefining, 12 
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keyboard recorded macros, 2-3 
listing of, 394 
macro starter, 395 
naming macros, 415-420 
repeating, 28 
routines 
placement of routines/subroutines, 
436-437 
separating routines, 436 
storage in subdirectories, 423-425 
time savers in creating, 426-427 
types of 
permanent Alt-key macros, 7-8 
permanent names macros, 9-11 
permanent remapped-key macros, 8- 
9 
temporary macros, 7, 11-12 
uses of, 2-5 
Macro sets, 24 
Macro style execution, 150 
Manual-entry templates, 120-125 
blank spaces, 121-124 
codes and symbols, 124 
comments, 125 
use of, 120 
Manuscript preparation 
footnotes/endnotes, 333-335 
endnote placement, 
ENDPLACE.WPM, 334 
ENDNOTE.WPM, 334 
FOOTNOTE.WPM, 333 
numbering, FOOTNUM.WPM, 334 
options menu, 335 
renaming macros, 333 
headers/footers, 327-332 
constructing library for, 330-331 
defining new header/footer, 
HEADER.WPM, 
327-328 
macro "prefixes" for, 331-332 
examples of, 332 
HEAD.WPM, 331-332 
TEST1.WPM, 331-332 
suppressing 
SUPAFOOT.WPM, 330 


SUPAHEAD.WPM, 329 
SUPBFOOT.WPM, 330 
SUPHEAD.WPM, 330 
turning off, OFFAHEAD.WPM, 329 

index preparation, 348-352 
INDEX1.WPM, 351-352 
INDEXWRD.WPM, 349-350 
MARKIND.WPM, 349 
marking for heading/subheading, 

349-351 

marking index, 348-349 

line spacing, 322-327 
AUTOSP2.WPM, 325 
double-space, 323 
one-and-a-half-space, 322-323 
OPEN1.WPM, 324 
open space, 323-327 
OPENSP.STY, 327 
single space, 322 

outlines, 339-340 
enhanced outline, 339-340 
levels of entry, 346 
OUTLINE1.WPM, 339-340 
OUTLINE.WPM, 337-339 
setting outline level, 336-337 

scripts, 340-346 

table of contents, 347-348 
GENERATE.WPM, 348 
MARKTOC.WPM, 347 

writing/editing, 352-359 

See also Writing/editing. 


MARKTOC.WPM, 347 
Memos, 173-176 


basic memo, 173-174 
MEMO.WPM, 173-174 

reply memo, 174-175 
REPMEMO.WPM, 174 


Menu merges, 108-113 


compatibility with 5.0 WordPerfect, 
112-113 

example of, 108-109 

menu list, saving, 110 

tips for using, 110-112 


MENUPAGE.WPM, 92-94 
Menus 


batch files, 481-484 
MENU.BAT, 482-483 
parts of, 89-90 


See also Custom menus; Menu merges. 


Merge 
labels, merge printing, 295-297, 298- 
299 
menu merges, 108-113 


compatibility with 5.0 WordPerfect, 


112-113 
example of, 108-109 
merged letters, 172 
primary file in, 126, 129 
secondary file in, 126 
merge entry templates, 130-136 
stopping of macro during, 472 


template document and manual-merge 


operation, 113-114 
Merge entry templates, 125-136 
automatic repeat, 129-130 
AUTOMERG.WPM1, 135-136 
AUTOMERG.WPM, 132-135 
boilerplate document assembly, 130 
filling out template, 129 
from secondary file, 130-136 
merge codes, entering, 127 
merge codes list, 128 
Message strings, 433-434 
bell, adding, 436 
improving appearance, 433-434 
more than one line, 435 
Mileage, calculating for business, 281- 
282 
Moving announcement, 187 
MOVING.MRG, 187, 189 
MRGORD1.WPM, 218 
MRGORD.WPM, 215-218, 219 
MRGR.WPM, 268 


N 
Name searches, 441 
Naming macros, 417 

to avoid disaster, 423-424 
Nesting 
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methods for, 470 
(NEST) macro~, programming state- 
ment, 72 
tips for, 422 
New account, 187, 191 
NEWACCT.MRG, 187, 190 
NEWFUNCT.WPK, 500 
NEWFUNCT.WPK layout, 51-52 
NEWINV.WPM, 261 
NOPAY.WPM, 210 
Note pad, 370-374 
SCRMEMO.WPM, 370-872 
switched note pad macro, 372-374 
SWMEMO.WPM, 372-374 
unswitched note pad macro, 370-872 
*Not found* message, 31, 33, 460, 467- 
478 
NSFPAY.WPM, 210 


O 
OFFAHEAD.WPM, 829 
(ON CANCEL)command-~, programming 
statement, 
72 
(ON ERROR)command~, programming 
statement, 73 
limiting mistakes with, 464 
1UPLABEL.MRG, 295-296 
{ON NOT FOUND)command~, program- 
ming statement, 73 
Open styles, 141 
Operators 
used with variables 
AND/OR operators, 838-86 
listing of, 82-83 
multiple operators, 86 
See also AND/OR operators. 
ORDENC.WPM, 210, 211 
Orders for products, 194 
LETORDER.MRG, 194, 196-197 
ORDPRI.MRG, 212 
{ORIGINAL KEY), programming state- 
ment, 73 
Outlines, 335-3840 
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enhanced outline, 339-340 
levels of entry, 336 
OUTLINE1.WPM, 339-340 
OUTLINE.WPM, 337-339 
setting outline level, 336-337 


P 
Paired styles, 140, 142, 144 
PAL12.WPM, 246 
PAL18.WPM, 246 
Paragraph numbering, 391-392 
contracts, 227 
Level 1, 391 
PARNUM.WPM, 391 
manual, PARNUM1.WPM, 392 
PASTE.WPM, 353 
Pasting copied text, 353 
{PAUSE), programming statement, 73 
Pausing macros, 19-22 
example MEMO.WPM, 21-22 
replaying macro, 21 
steps in, 20-21 
usefulness of, 19-20 
Permanent Alt-key macros, 7-8 
Permanent names macros, 9-11 
Permanent remapped-key macros, 8-9 
Phone messages, 374-379 
create PHONE directory, 375 
delete messages, 378-379 
DELPHN.WPM, 378-379 
print messages, 377-378 
PRINTPHN.WPM, 377-378 
redoing message, 376-377 
WHILOUTI.WPM, 376-377 
WHILEOUT.WPM, 375-376 
Point-of-sale receipts, 271-278 
FILLIN.WPM, 271, 273-278 
format codes, 277-278 
Pop-up windows, creating, 450-453 
Primary file, in merge, 126, 129 
Printing 
backwards printing, 405-408 
BACKPR1.WPM, 406 
BACKPR2.WPM, 407 


BACKPR3.WPM, 407 
selected pages, 393-394 
PRPAGE.WPM, 393-394 
PRINTPHN.WPM, 377-378 
PRLABEL1.WPM, 293-294 
PRLABEL.WPM, 291-293 
Programming. See Macro programming 
Prompt 
displayed in status line, 431-432 
user entry, 433 
{PROMPT} message~, programming 
statement, 73-74 
Proverb maker, 387-389 
PROVERB.TXX, format of, 387-389 
PROVERB.WPM, 387-388-389 
and WordPerfect start-up, 387 
PRPAGE.WPM, 393-394 
PUBRITE.WPM, 228 


Q 
QUIKKEYS.WPK, 500, 502 
layout, 51 
{QUIT}, programming statement, 74, 
459 
Quiz macro, 381-386 
modified quiz, 384-385 
question/answer document 
ANSWERS. TXT, 381 
formatting, 381 
QUIZ.WPM, 382-385 
Quotes for services/products, 191, 194 
QUOTE1.MRG, 191, 193 


R 
RECDEL.WPM, 405 
Record sorter, 403-404 
SORTDIR.WPM, 404 
Referencing, automatic contracts, 223- 
224 
Reply letters, 197-221 
with automatic labels, 218-221 
LABELPRI.MRG, 220-221 
LABELSEC.MRG, 220 


MRGORD1.WPM, 218 
MRGORD.WPM, 219 
primary label document, 218-219 
COD orders 
NOCOD.MRG, 203 
nonacceptance, 202, 205 
donations, 205 
DONATE.MRG, 205, 206 
layout of, DELAY.MRG, 197, 198 
macro-driven letters, 205-221 
CLINQ.WPM, 211 
CLORD.WPM, 211 
HNFPAY.WPM, 207 | 
manual document assembly, 207-212 
NOPAY.WPM, 210 
NSFPAY.WPM, 210 
ORDENC.WPM, 210, 211 
ORDERLY.WPM, 207, 209, 212 
TYINQ.WPM, 207, 209 
TYORD.WPM, 207, 209 
macros for automatic document as- 
sembly, 
212-218 
auto-assemble template, 215 
MRGORD.WPM, 215-218 
ORDPRI.MRG, 212 
sample assembled documents, 218, 
214 
orders 
not filled, 197, 199 
SOLDOUT.MRG, 199, 200 
resumes/employment applications, 
199, 202 
REPLY.MRG, 199, 201 
unmet financial obligations, 202 
DLYPAY.MRG, 202, 203 
REPMEMO.WPM, 174 
Requests 
CHRGEQ.MRG, 191, 192 
credit, 191 
CHRGEQ.MRG, 191, 192 
(RESTART), programming statement, 74 
RESTATE1.MRG, 184, 185 
RESTATE2.MRG, 184, 186 
Resumes, 305-319 
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chronological-format resume, 312, 914- 
316 
references, handling of, 314, 316 
RESUMES.WPM, 312, 814, 316 
uses of, 312 
complete entry resume, 316-318 
RESUME4.WPM, 316-318, 329 
custom-made, handling of, 319 
skill format resume, 306-312 © 
formatting codes, 306 
non-indented, 309, 311-312 
RESUME1.WPM, 306-308, 310, 319 
RESUME2.WPM, 309, 311-312, 313 
template, 306-307 
uses of, 306 
{RETURN}, programming statement, 74 
(RETURN CANCEL), programming 
statement, 75 
(RETURN ERROR), programming state- 
ment, 75 
(RETURN NOT FOUND), programming 
statement, 75 
RIGHT.FMT, 390 


S 
SAVESUB.WPM, 102-103 
SCHOOL24.WPM, 246 
Screen 
clearing, 394-395 
CLS.WPM, 394-395 
Scripts, 340-356 
action selection, 341-344 
dialog macro, 344 
chained dialog macro, 346 
CHAR.WPM, 340-345 
TALK.WPM, 346 
dialog selection, 341 
DIALOGUE style, 341, 343 
format setting 
with macros, 343-346 
with styles, 341, 343 
Searches, 424, 426 
backwards search, 425 


530 Index 


extended search through document, 
425 
for invisible soft returns, 425 
miscellaneous searches, 426 
not found, 467-468 
changing instructions, 435-437 
for soft pages, 424 
for soft returns, 425 
Secondary file, merge entry templates 
from,130-136 
Secondary merge files 
document conversion, 364-368 
adding merge codes to tab-delimited 
files, 368 
comma-delimited files converted to, 
367 
conversion to line/column format, 
365-366 
CONVERT.WPM, 368 
hard returns changed to com- 
mas/tabs, 
366-367 
STRIP1.WPM, 365-366 
STRIP2.WPM, 366 
STRIPCOM.WPM, 367 
STRIPTAB.WPM, 367 
tab-delimited files converted to, 367 
list manager, 404-405 
RECDEL.WPM, 405 
Security, locking/unlocking files, 491- 
492 
Semi-blocked letters, 165-169 
example, 165 
SEMIBLOK.WPM, 167 
(,}comment~, programming statement, 
66 
Separate macros, 24 
SIZE.WPM, 356 
SORTDIR.WPM, 404 
SORTMAC.WPM, 99-102 
{SPEED)1/100th secs.~, programming 
statement, 
75, 459-460 
Standing elements, desktop publishing, 
237, 239 


(STATE) 
programming statement, 75-76 
testing WordPerfect, 446-448 
(STEP OFF), programming statement, 
76 
(STEP ON), programming statement, 
76, 449-460 
Strings, 63 
text, variables with, 86 
STRIP1.WPM, 365-366 
STRIP2.WPM, 366 
STRIPCOM.WPM, 367 
STRIPTAB.WPM, 367 
STYCHAINS.WPM, 151 
Styles, 139-154 
accessing styles 
Applications Disk, 499 
hard disk subdirectory, 500 
WordPerfect directory, 500 
Applications Disk, 499 
automatic "off' codes, 145 
copying style definitions, 149-150 
defining, 141-144 
by command, 141-142 
by example, 143-144 
explanation of, 139-140 
macro style execution, 150 
open styles, 141 
paired styles, 140, 142, 144 
retrieving styles, 147 
saving styles, 146-147 
storage, in document, 141, 146 
style chains, 150-152 
STYCHAINS.WPM, 151 
style codes screen, 142 
style hierarchy 
construction of, 152-153 
subordinate style in, 153 
style library, 147-149 
adding styles to document, 149 
defining, 147-148 
merging styles, 148-149 
style off/on switches, 153-154 
tips/shortcuts, 146 
turning off, 144-145 


turning on, 144 
updating saved styles, 147 
STYLE.WPM, 356 
SUBDIR.BAT, 490 
Subdirectories 
accessing 
with DOS, 502-503 
macros, locating, 504 
with WordPerfect, 503-510 
Subroutines, 63 
and macro levels, 65, 66 
tips for, 422 
Subscript, 358-359 
SUB.WPM, 358 
SUPAFOOT.WPM, 330 
SUPAHEAD.WPM, 329 
SUPBFOOT.WPM, 330 
Superscript, 358 
SUPER.WPM, 358 
SUPHEAD.WPM, 330 
SWMEMO.WPM, 372-374 


T 
{TAB}, programming statement, 77 
TABLEAD.WPM, 389-390 
Table of contents, 347-348 
GENERATE.WPM, 348 
MARKTOC.WPM, 347 
TALK.WPM, 346 
Templates 
Applications Disk, 499 
desktop publishing, standing ele- 
ments, 
237, 239 
erasing, prevention of, 118 
expense reports (auto-calculated), 278- 
288 
EXPENSES.TMP, 278, 280-281, 282- 
288 
information entered, 281 
mileage, 281-282 
printer for, 278, 281 
specific formatting for, 281 
format templates, 119-120 
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for invoices 
auto-calculated invoice, 262, 266 
INV.TAT, 256, 257 
manual-entry templates, 120-125 
blank spaces, 121-124 
codes and symbols, 124 
comments, 125 
use of, 120 
manual-merge operation, 118-114 
merge entry templates, 125-136 
automatic repeat, 129-130 
AUTOMERG.WPM1, 135-136 
AUTOMERG.WPM, 132-135 
boilerplate business correspondence, 
178-179 
boilerplate document assembly, 130 
filling out template, 129 
from secondary file, 180-136 
merge codes, entering, 127 
merge codes list, 128 
secondary merge document, creat- 
ing, 179- 180 
preparation methods, 118 
resumes, 306, 307 
saving of, 118 
to-do list, TODO.TXT, 400, 401 
Temporary macros, 7, 11-12 
TEST1.WPM, 331-332 
Text, transferring between documents, 
438-440 
(TEXT) variable~message~, program- 
ming statement, 77 
3UPLABEL.MRG, 298-299 
Tilde (~) 
cautions about, 472 
as delimiter, 64 
Time stamp macro, TIME.WPM, 392 
To-do list, 400-403 
adding to, 403 
template, TODO.TXT, 400-401 
TODO.WPM, 400, 402-403 
Truth tables, AND/OR operators, 83-84, 
445 
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U 

Underline, 354 
UNDERLN.WPM, 354 

UNLOCK.BAT, 492 

Unpaid checks, 184, 187 
BDCHECK.MRG, 184, 187, 188 


yV 
Variables 
assigning, 52-53 
erasing, 53 
steps in, 52 
uses of, 52 
assigning correct number, 468-469 
limitations of, 469 
quotation marks, use of, 465 
values assigned to, 80-86 
AND/OR operators, 83-86 
maximum characters, 81 
methods of, 80-81 
multiple operators, 86 
operators with variables, 82-86 
text strings, using, 86 
Video graphics array (VGA), desktop 
publishing, 232 
Viewing document, 244-245 
VIEW.WPM, 245 


W 

{WAIT)1/10th secs.~, programming 
statement, 77 

WARRANTY.WPM, 229 

WHILEOUT.WPM, 375-376 

WHILOUTI1.WPM, 376-377 


Word count, WOCOUNT.WPM, 393 
WordPerfect, testing, {STATE} instruc- 
tion, 446-448 
WordStar 
converting files to WordPerfect, 486- 
487 
equivalent keys, 48-52 
listing of, 49 
steps in making, 49-50 
WORDSTAR.WPK, 500 
WPFORMAT.BAT, 489 
Writing/editing, 352-359 
bold-face, 354 
centering text, 356-368 
already written text, 356 
previously written text, 357-358 
starting at tab stop, 358 
copy text block/place in buffer, 353 
copy text block to buffer, 352-353 
delete paragraph, 352 
delete sentence, 352 
document conversion, 359-369 
font size, changing, 355-356 
already written text, 355 
before writing, 356 
font style, changing, 355-356 
already written text, 355 
before writing, 356 
hanging paragraph indent, 358 
pasting copied text, 353 
subscript, 358-359 
superscript, 358 
underline, 354 
See also Document conversion; 
Scripts. 
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IBM PS/2-Compatible 3.5" Diskettes 


This Bantam software product is also available in IBM PS/2- compatible 
3.5"/720K format. If you’d like to exchange this software for the new 3.5" 
format, please: | 


e Package your original 5.25" diskette in a mailer. 
e Include a check or money order for $7.95 ($9.95 


Canadian) to cover media, postage and handling 
(California and Massachusetts residents add sales tax). 


e Include your completed warranty card. 


Upon receipt Bantam will immediately send your replacement disk via 
first class mail. 


Mailing address: 


Bantam Electronic Publishing 
666 Fifth Avenue 

New York, NY 10103 

Attn: WPM 3.5" Disk 


Enclosed is your Applications Disk 


The enclosed 360K, 5¥%-inch, IBM PC disk contains over 240 ready-to-run 
macros, styles and templates for WordPerfect 5.0. 


What’s on This Disk 

The files on the Applications Disk are stored in directories corresponding to the 
book chapters in which they are described. A complete list of the files appears 
in Appendix D. These files fall into seven different categories: 


© BATCH FILES—These help supercharge WordPerfect. 


@ BUSINESS LETTERS—Ready-made business letters for use with 
WordPerfect’s merge feature 


@ GAME FILES—These create a macro-based adventure game. 


a KEYBOARD LAYOUTS—These allow you to customize WordPerfect’s key 
functions in a miriad of different ways. 


= MACROS—The complete collection of time-saving macros discussed in this 
book. 


Œ STYLES—Instant page formats for charts, tables, memos, scripts, desktop 
publishing and more. 


m TEXT FILES—For use with the various macros. 
All macros, styles and templates are completely customizable. 


How to Use This Disk 

l. Make a backup copy of the Applications Disk and store the original in a safe 
place. 

2. Load WordPerfect 5.0 into your IBM PC or compatible. 

3. Place the copy of your Applications Disk in drive A: or B: 

4. At the WordPerfect document screen, type [Alt]-[F10]. Then enter A: HELP 
or B: HELP. This invokes a macro that presents complete instructions for 
installing and using the macros, styles and templates included with the 
Applications Disk. After permanently installed, this instrucuon macro will be 
instantly available anytime you’re using WordPerfect. 


Hardware/Software Requirements 


IBM PC or close compatible 
WordPerfect Release 5.0 


WordPerfect is a trademark of WordPerfect Corporation, 


Faster Than a Speeding Bullet... 


Looking for a way to increase your efficiency with WordPerfect, the best-selling 
word processor for the IBM PC? You’ve found it! In this complete and 
authoritative guide, author Gordon McComb gives you full command of 
WordPerfect 5.0’s powerful arsenal of macros, styles and templates. 


WordPerfect 5.0 Macros and Templates shows you how to fly high with these 
powerful tools, and takes you far beyond what you’ll find in the WordPerfect 
manual. Inside this book/software package vou’ll discover plenty of easy-to- 
follow examples, instructions and tips on: 


=m Creating and modifying macros—for any application. 

@ Customizing your keyboard with 5.0’s new key remapping feature. 
@ Preparing and printing letters and memos automatically. 

@ Desktop publishing with quick and easy formats. 

s Naming and storing macros and templates for easy access. 


@ Using merge printing with macros and templates for filling out forms, invoices. 
and tax records. 


= Saving time with macros when preparing tables of contents or indexes. 
= Using macros to combine text and graphics—quickly and painlessly. 


You’ll also find a complete disk library of over 40 modifyable macros, styles and 
. templates that you can use right now! 


Gordon McComb has written a dozen books, including Bantam’s Executive Guide 
to PC Presentation Graphics. His writing has appeared in Popular Science, Omni, . 
High Technology, Popular Electronics, Macworld, PC World and many other top 
consumer and trade publications. 
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